Accesso ai dati dettagliati nel pannello di controllo Shopify tramite JSON

JSON, acronimo di JavaScript Object Notation, è un formato per l’archiviazione e il trasporto dei dati, spesso utilizzato quando i dati vengono inviati dai server alle pagine web. Nella maggior parte delle pagine delle risorse del pannello di controllo Shopify, come le pagine Ordini, Prodotti o Clienti, puoi accedere a dati più dettagliati utilizzando il formato JSON.

Anche se non è necessario eseguire attività di sviluppo avanzate utilizzando JSON, la possibilità di accedere al file JSON di una particolare risorsa nel pannello di controllo Shopify può aiutarti a raccogliere informazioni più dettagliate o a risolvere autonomamente i problemi. Ad esempio, puoi esaminare il file JSON di un prodotto per trovare il suo ID variante, che può essere richiesto per determinate attività di migrazione dei dati o personalizzazioni del codice del tema. Oppure, puoi fare riferimento al file JSON di un ordine per confermare la variabile di dati che desideri utilizzare durante la creazione di un flusso di lavoro automatizzato in Shopify Flow.

JSON è utilizzato più spesso dagli sviluppatori, ma anche gli utenti con conoscenze di codifica limitate possono trarre vantaggio dall'imparare a trovare e interpretare alcune informazioni JSON comuni nel pannello di controllo Shopify.

In questa pagina

Riformattazione di un file JSON

I dati JSON non elaborati vengono visualizzati come una lunga sequenza di variabili e parentesi nidificate, difficile da leggere per un utente.

Per rendere la formattazione JSON più leggibile, valuta una delle seguenti opzioni:

Installa un’estensione per la visualizzazione di JSON nel browser.
Utilizza la funzionalità “pretty-print” che la maggior parte dei browser web moderni ha a disposizione per impostazione predefinita:

Schermata di un file JSON di un prodotto con informazioni di esempio visualizzate. L’impostazione della casella di spunta “pretty-print” è attiva, evidenziata in alto a sinistra nella pagina.

Accesso ai file JSON nel pannello di controllo Shopify

Il pannello di controllo Shopify è l'hub centrale per la gestione di tutti gli aspetti della tua attività ed è progettato per mostrare per impostazione predefinita solo le informazioni più utili e pertinenti. Le informazioni aggiuntive raccolte ogni volta che vengono eseguite azioni nel pannello di controllo vengono archiviate nei file .json di diverse pagine delle risorse. Questi dettagli aggiuntivi non vengono visualizzati per impostazione predefinita perché tale quantità di informazioni sarebbe eccessiva e poco utile e renderebbe il pannello di controllo difficile da usare.

Per la maggior parte delle attività aziendali, puoi utilizzare gli strumenti esistenti di Shopify per accedere e interpretare le informazioni del tuo negozio. Tuttavia, a volte può essere utile esaminare le informazioni specifiche su determinate risorse, come prodotti o ordini, per risolvere i problemi relativi al motivo o al momento in cui si è verificato qualcosa.

Esempio: accedere al file JSON di un ordine

In questo esempio, accederai al file JSON di un ordine nel pannello di controllo Shopify.

Passaggi:

Dal pannello di controllo Shopify, vai a Ordini.
Clicca su un ordine qualsiasi nell'elenco Ordini.
Nella barra degli indirizzi del browser, aggiungi .json alla fine dell'indirizzo URL. Sarà simile a questo esempio:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json

Premi Invio per ricaricare la pagina in formato JSON.
Facoltativo: se non hai un’estensione per la visualizzazione di JSON installata nel browser, attiva l’impostazione Pretty-print nel browser per rendere il file JSON più facile da usare. Scopri di più sulla riformattazione di un file JSON.

Noterai che vengono visualizzate molte informazioni previste sull'ordine, come "currency" e "line_items" associati, ma sono incluse anche molte altre informazioni dettagliate, come "client_details" dalla sessione del browser del cliente quando ha effettuato l'ordine. Questo tipo di informazioni è utile per il monitoraggio generale della sessione e per l'analisi della piattaforma di marketing, ma non è necessario per elaborare ed evadere l'ordine.

Visualizzazione di campi specifici in un file JSON

Puoi forzare i file JSON a visualizzare solo campi specifici, il che può rendere le informazioni più facili da interpretare quando conosci le proprietà specifiche che desideri includere. Alla fine di qualsiasi URL di un file JSON nella barra degli indirizzi del browser, aggiungi ?fields= e includi i nomi delle proprietà che desideri visualizzare, in qualsiasi ordine, separati da una virgola.

Ad esempio, per visualizzare l'ID di un ordine, le informazioni sul cliente, il prezzo totale e i tag, aggiungi ?fields=id,customer,total_price,tags alla fine dell'URL del file JSON, come nell'esempio seguente:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json?fields=id,customer,total_price,tags

Utilizzo di altre risorse JSON

Puoi utilizzare le seguenti risorse JSON per visualizzare informazioni specifiche nel pannello di controllo Shopify:

Conteggio prodotti: aggiungi /count.json alla fine dell’URL dell’elenco Prodotti per visualizzare il numero totale di prodotti. L’URL completo dovrebbe essere:

https://admin.shopify.com/store/{example-shop-name}/products/count.json

Transazioni: aggiungi /transactions.json alla fine dell’URL di una pagina di ordine per visualizzare solo le informazioni sulla transazione dell’ordine. Scopri di più sulla risorsa Transazioni.
Evasioni: aggiungi /fulfillments.json alla fine dell’URL di una pagina di ordine per visualizzare solo le informazioni sull’evasione dell’ordine. Scopri di più sulla risorsa Evasione.
Check-out abbandonati: aggiungi .json alla fine dell’URL di un check-out abbandonato per visualizzare le informazioni dettagliate sul check-out abbandonato. Scopri di più sulla risorsa Check-out abbandonato.

Proprietà JSON comuni per la risoluzione dei problemi

La tabella seguente elenca le proprietà JSON a cui potresti voler fare riferimento per la risoluzione dei problemi con diversi tipi di risorse. Ad esempio, se desideri confermare quando un determinato prodotto è stato pubblicato, puoi consultare il file JSON del prodotto per la proprietà published_at, che visualizza la data e l'ora in formato ISO 8601.

Questa tabella non include tutte le possibili risorse o proprietà JSON archiviate nel pannello di controllo Shopify, quindi fai riferimento alla documentazione per gli sviluppatori di Shopify per le definizioni di qualsiasi risorsa o proprietà non inclusa qui.

Elenca alcune risorse di esempio del pannello di controllo e le proprietà comuni associate, incluse le definizioni del loro possibile utilizzo per la risoluzione dei problemi.
Risorsa	Proprietà JSON	Definizione
Prodotto	`"product": { "created_at"`	Data e ora di creazione iniziale del prodotto.
	`"product": { "published_at"`	Data e ora in cui lo stato del prodotto è stato impostato su Attivo.
	`"product": { "updated_at"`	Data e ora dell'aggiornamento più recente del prodotto. Questo può includere modifiche alla descrizione del prodotto, al titolo o alle informazioni SEO, nonché aggiornamenti automatici come le modifiche alle scorte quando un prodotto viene acquistato.
Variante	`"product": { "variants": [ { "created_at"`	Data e ora di creazione iniziale della variante. Possono essere diverse da data e ora di creazione del prodotto complessivo.
	`"product": { "variants": [ { "updated_at"`	Data e ora dell'aggiornamento più recente della variante. Possono essere diverse da data e ora dell'ultimo aggiornamento del prodotto complessivo.
	`"product": { "variants": [ { "inventory_quantity"`	Il valore attuale del database e quello accessibile ai clienti per l'acquisto. Potrebbe essere un valore negativo se le scorte della variante non vengono tracciate o se è impostata per l'overselling.
	`"product": { "variants": [ { "old_inventory_quantity"`	Il valore del database prima dell'ultima data `updated_at` della variante.
Ordine	`"order": { "line_items": [ { "requires_shipping"`	Visualizzato come `true` o `false`. Indica le impostazioni di spedizione del prodotto o della variante al momento dell'invio dell'ordine.
	`"order": { "line_items": [ { "taxable"`	Visualizzato come `true` o `false`. Indica come era impostato l'addebito delle imposte per il prodotto o la variante al momento dell'invio dell'ordine.
	`"order": { "line_items": [ { "variant_inventory_management"`	Visualizzato come `shopify`, `amazon_marketplace_web`, `null` o un valore di terze parti a seconda di quale servizio logistico è impostato per tracciare le scorte del prodotto. Un valore `null` indica che il prodotto non veniva tracciato al momento dell'ordine.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Mostra quante scorte sono ancora riservate dal sistema per completare l'ordine. Questo valore non corrisponde alle scorte attuali della variante.
	`"order": { "line_items": [ { "quantity"`	Il numero di prodotti o varianti acquistati.
	`"order": { "line_items": [ { "tax_lines"`	Negli Stati Uniti, visualizza i valori statali, di contea e comunali. Se non viene visualizzata alcuna riga relativa alle imposte, ma sull'ordine sono state addebitate delle imposte, significa che l'imposta è stata addebitata sul costo di spedizione.
Cliente	`"customer": { "created_at"`	Data e ora di creazione iniziale del cliente.
Cliente	`"customer": { "updated_at"`	Data e ora dell'aggiornamento più recente del profilo cliente.

Metafield in JSON

I metafield sono un modo flessibile per associare informazioni personalizzate aggiuntive a una risorsa Shopify, come prodotti o collezioni. Alcuni esempi di dati archiviati utilizzando i metafield includono specifiche di prodotto, tabelle delle taglie, documenti scaricabili, date di uscita, immagini o codici componente. Scopri di più sull’utilizzo dei metafield.

Puoi aggiungere /metafields.json alla fine dell'URL di una pagina di risorsa supportata per visualizzare i metafield associati a quella risorsa. Consulta la tabella seguente per alcuni esempi di risorse e formati di URL da utilizzare per visualizzare le informazioni sui metafield utilizzando JSON.

Elenco di alcune risorse di esempio del pannello di controllo con un URL di esempio del file JSON dei metafield.
Tipo di risorsa di esempio	URL di esempio
Collezione smart	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Cliente	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Ordine	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Pagina	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Prodotto	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Variante	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Immagine del prodotto	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Nota: i metafield dell’immagine del prodotto possono essere aggiunti solo tramite l’API. Sostituisci `{id}` e gli altri segnaposto nell’URL con i valori effettivi delle query dell’API.
Negozio	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Per un elenco completo delle risorse che possono avere metafield e dei tipi specifici di proprietà archiviate per ogni tipo di risorsa, fai riferimento alla risorsa JSON Metafield nella documentazione per gli sviluppatori di Shopify.

Eventi in JSON

Gli eventi vengono generati da alcune risorse Shopify al completamento di determinate azioni, come la creazione di un articolo del blog, l'evasione di un ordine o l'aggiunta di un prodotto.

Puoi aggiungere /events.json alla fine dell'URL di una pagina di risorsa supportata per visualizzare gli eventi associati a quella risorsa. Consulta la tabella seguente per alcuni esempi di risorse e formati di URL da utilizzare per visualizzare le informazioni sugli eventi utilizzando JSON.

Elenco di alcune risorse di esempio del pannello di controllo con un URL di esempio del file JSON degli eventi.
Tipo di risorsa di esempio	URL di esempio
Ordine	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Questo file elenca l'`author` degli eventi, informandoti su quali utenti hanno completato determinate azioni, ad esempio chi o cosa ha pubblicato un prodotto.
Prodotto	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Questo file elenca l'`author` degli eventi, informandoti su quali utenti hanno completato determinate azioni, ad esempio chi o cosa ha contrassegnato un pagamento come pagato.
Negozio	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Questo formato di URL visualizza i 250 eventi più recenti che si sono verificati nel negozio. Gli eventi possono includere, a titolo esemplificativo, la creazione o l'aggiornamento di prodotti, l'eliminazione di pagine e l'aggiornamento di varianti.

Per un elenco completo delle risorse che possono creare eventi e degli eventi specifici creati per ogni tipo di risorsa, fai riferimento alla risorsa JSON Evento nella documentazione per gli sviluppatori di Shopify.