Accesarea datelor detaliate în panoul de administrare Shopify folosind JSON

JSON, prescurtarea de la JavaScript Object Notation, este un format pentru stocarea și transportul datelor, utilizat adesea atunci când datele sunt trimise de pe servere către pagini web. În majoritatea paginilor de resurse din panoul de administrare Shopify, cum ar fi paginile Comenzi, Produse sau Clienți, puteți accesa date mai detaliate utilizând JSON.

Deși nu trebuie să efectuați sarcini de dezvoltare avansate folosind JSON, posibilitatea de a accesa fișierul JSON pentru o anumită resursă din panoul de administrare Shopify vă poate ajuta să colectați informații mai detaliate sau să depanați sau să investigați singur problemele. De exemplu, puteți revizui fișierul JSON pentru un produs pentru a-i găsi ID-ul de variantă, care poate fi necesar pentru anumite sarcini de migrare a datelor sau pentru personalizări ale codului temei. Un alt exemplu, puteți consulta fișierul JSON al unei comenzi pentru a confirma variabila de date pe care doriți să o utilizați la crearea unui flux de lucru automatizat în Shopify Flow.

JSON este cel mai adesea utilizat de dezvoltatori, dar chiar și utilizatorii cu cunoștințe limitate de codare pot beneficia de pe urma învățării modului de a găsi și interpreta unele informații JSON comune în panoul de administrare Shopify.

Pe această pagină

Reformatarea unui fișier JSON

Datele JSON brute se afișează ca o secvență lungă de variabile și paranteze imbricate, care este dificil de citit pentru un utilizator uman.

Pentru a face formatarea JSON mai lizibilă, luați în considerare oricare dintre următoarele opțiuni:

Instalați o extensie de vizualizare JSON în browserul dumneavoastră.
Utilizați funcționalitatea „pretty-print” pe care majoritatea browserelor web moderne o au disponibilă în mod implicit:

Captură de ecran a unui fișier JSON de produs cu exemple de informații despre produs afișate. Setarea căsuței de selectare „pretty-print” este activă, evidențiată în partea din stânga sus a paginii.

Accesarea fișierelor JSON în panoul de administrare Shopify

Panoul de administrare Shopify este centrul principal pentru gestionarea tuturor aspectelor afacerii dumneavoastră și este conceput pentru a afișa în mod implicit doar cele mai utile și relevante informații. Informațiile suplimentare care sunt colectate ori de câte ori sunt efectuate acțiuni în panoul de administrare sunt stocate în fișierele .json ale diferitelor pagini de resurse. Aceste detalii suplimentare nu vă sunt afișate în mod implicit, deoarece această cantitate de informații ar fi copleșitoare și nefolositoare și ar face dificilă utilizarea panoului de administrare.

Pentru majoritatea sarcinilor de afaceri, puteți utiliza instrumentele existente ale Shopify pentru a accesa și interpreta informațiile magazinului dumneavoastră. Cu toate acestea, poate fi ocazional util să consultați informațiile specifice despre anumite resurse, cum ar fi produsele sau comenzile, atunci când depanați de ce sau când s-a întâmplat ceva.

Exemplu: Accesarea fișierului JSON al unei comenzi

În acest exemplu, veți accesa fișierul JSON al unei comenzi în panoul de administrare Shopify.

Pași:

Din panoul de administrare Shopify, accesați Comenzi.
Faceți clic pe orice comandă din lista Comenzi.
În bara de adrese a browserului, adăugați .json la sfârșitul adresei URL. Va fi similar cu acest exemplu:

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

Apăsați Enter pentru a reîncărca pagina în format JSON.
Opțional: dacă nu aveți instalată o extensie de vizualizare JSON în browser, activați setarea Pretty-print în browser pentru a face fișierul JSON mai ușor de utilizat. Aflați mai multe despre reformatarea unui fișier JSON.

Veți observa că sunt afișate multe informații așteptate despre comandă, cum ar fi „currency” și „line_items” asociate cu comanda, dar sunt incluse și multe alte informații detaliate, cum ar fi „client_details” din sesiunea de browser a clientului atunci când a plasat comanda. Acest tip de informații este util pentru urmărirea generală a sesiunilor și pentru datele analitice ale platformei de marketing, dar nu este necesar pentru ca dumneavoastră să procesați și să onorați comanda.

Afișarea unor câmpuri specifice într-un fișier JSON

Puteți forța fișierele JSON să afișeze doar anumite câmpuri specifice, ceea ce poate face informațiile mai ușor de interpretat atunci când cunoașteți proprietățile particulare pe care doriți să le includeți. La sfârșitul oricărui URL de fișier JSON din bara de adrese a browserului, adăugați ?fields= și apoi includeți numele proprietăților pe care doriți să le afișați, în orice ordine, separate printr-o virgulă.

De exemplu, pentru a afișa ID-ul unei comenzi, informațiile despre client, prețul total și etichetele, adăugați ?fields=id,customer,total_price,tags la sfârșitul URL-ului fișierului JSON, ca în următorul exemplu:

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

Utilizarea altor resurse JSON

Puteți utiliza următoarele resurse JSON pentru a afișa informații specifice în panoul de administrare Shopify:

Număr de produse: adăugați /count.json la sfârșitul URL-ului listei de Produse pentru a afișa numărul total de produse. URL-ul complet ar trebui să fie:

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

Tranzacții: adăugați /transactions.json la sfârșitul URL-ului unei pagini de comandă pentru a afișa numai informațiile despre tranzacția comenzii. Aflați mai multe despre resursa Tranzacții.
Onorări comenzi: adăugați /fulfillments.json la sfârșitul URL-ului unei pagini de comandă pentru a afișa numai informațiile despre onorarea comenzii. Aflați mai multe despre resursa Onorare comandă.
Plăți abandonate: adăugați .json la sfârșitul URL-ului unei plăți abandonate pentru a afișa informații detaliate despre plata abandonată. Aflați mai multe despre resursa Plată abandonată.

Proprietăți JSON comune pentru depanare

Următorul tabel enumeră proprietățile JSON pe care poate doriți să le consultați pentru asistență la depanare cu diferite tipuri de resurse. De exemplu, dacă doriți să confirmați când a fost publicat un anumit produs, puteți consulta fișierul JSON al produsului pentru proprietatea published_at, care afișează data și ora în format ISO 8601.

Acest tabel nu include fiecare resursă sau proprietate JSON posibilă stocată în panoul de administrare Shopify, așa că vă rugăm să consultați Documentația pentru dezvoltatori Shopify pentru definițiile oricărei resurse sau proprietăți care nu este inclusă aici.

Prezintă câteva exemple de resurse de administrare și proprietăți comune asociate acestora, inclusiv definiții pentru ceea ce ar putea fi utilizate la depanare.
Resursă	Proprietate JSON	Definiție
Produs	`"product": { "created_at"`	Data și ora la care a fost creat inițial produsul.
	`"product": { "published_at"`	Data și ora la care starea produsului a fost setată la Activ.
	`"product": { "updated_at"`	Cea mai recentă dată și oră la care a fost actualizat produsul. Aceasta poate include modificări ale descrierii produsului, titlului sau informațiilor SEO, precum și actualizări automate, cum ar fi modificări ale inventarului atunci când un produs este achiziționat.
Variantă	`"product": { "variants": [ { "created_at"`	Data și ora la care a fost creată inițial varianta. Aceasta poate fi diferită de data și ora la care a fost creat produsul per ansamblu.
	`"product": { "variants": [ { "updated_at"`	Cea mai recentă dată și oră la care a fost actualizată varianta. Aceasta poate fi diferită de data și ora la care a fost actualizat ultima dată produsul per ansamblu.
	`"product": { "variants": [ { "inventory_quantity"`	Valoarea curentă din baza de date și cea accesibilă clienților pentru achiziție. Aceasta ar putea fi o valoare negativă dacă inventarul variantei nu este urmărit sau dacă este setată pentru supravânzare.
	`"product": { "variants": [ { "old_inventory_quantity"`	Valoarea din baza de date anterioară ultimei date `updated_at` a variantei.
Comandă	`"order": { "line_items": [ { "requires_shipping"`	Se afișează ca `true` sau `false`. Indică setările de expediere ale produsului sau variantei la momentul plasării comenzii.
	`"order": { "line_items": [ { "taxable"`	Se afișează ca `true` sau `false`. Indică modul în care produsul sau varianta a fost setată să perceapă taxe în momentul plasării comenzii.
	`"order": { "line_items": [ { "variant_inventory_management"`	Se afișează ca `shopify`, `amazon_marketplace_web`, `null` sau o valoare externă, în funcție de serviciul de execuție a comenzii setat pentru a urmări inventarul produsului. O valoare `null` înseamnă că produsul nu era urmărit la momentul plasării comenzii.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Afișează cât inventar este încă rezervat de sistem pentru a finaliza comanda. Acesta nu este egal cu inventarul actual al variantei.
	`"order": { "line_items": [ { "quantity"`	Numărul de produse sau variante achiziționate.
	`"order": { "line_items": [ { "tax_lines"`	În Statele Unite, afișează valorile pentru stat, comitat și municipalitate. Dacă nu se afișează linii de taxă, dar s-a perceput taxă pentru comandă, atunci înseamnă că taxa a fost percepută pentru costul de transport.
Client	`"customer": { "created_at"`	Data și ora la care a fost creat inițial clientul.
Client	`"customer": { "updated_at"`	Cea mai recentă dată și oră la care a fost actualizat profilul clientului.

Metacâmpuri în JSON

Metacâmpurile sunt o modalitate flexibilă de a atașa informații personalizate suplimentare unei resurse Shopify, cum ar fi produse sau colecții. Câteva exemple de date stocate folosind metacâmpuri includ specificații de produs, diagrame de mărimi, documente descărcabile, date de lansare, imagini sau coduri de piesă. Aflați mai multe despre utilizarea metacâmpurilor.

Puteți adăuga /metafields.json la sfârșitul unui URL de pagină de resurse acceptat pentru a afișa metacâmpurile asociate cu resursa respectivă. Consultați tabelul de mai jos pentru câteva exemple de resurse și formate de URL-uri pe care să le utilizați pentru a afișa informații despre metacâmpuri folosind JSON.

Enumerați câteva exemple de resurse de administrare împreună cu un exemplu de URL de fișier de metacâmpuri JSON.
Exemplu de tip de resursă	Exemplu de URL
Colecție inteligentă	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Client	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Comandă	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Pagină	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Produs	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Variantă	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Imagine de produs	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Notă: Metacâmpurile imaginilor de produs pot fi adăugate numai prin API. Înlocuiți `{id}` și alți substituenți din URL cu valorile reale din interogările dumneavoastră API.
Magazin	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Pentru o listă completă a resurselor care pot avea metacâmpuri și tipurile specifice de proprietăți care sunt stocate pentru fiecare tip de resursă, consultați resursa JSON Metacâmp în Documentația pentru dezvoltatori Shopify.

Evenimente în JSON

Evenimentele sunt generate de unele resurse Shopify atunci când sunt finalizate anumite acțiuni, cum ar fi crearea unei postări pe blog, onorarea unei comenzi sau adăugarea unui produs.

Puteți adăuga /events.json la sfârșitul unui URL de pagină de resurse acceptat pentru a afișa evenimentele asociate cu resursa respectivă. Consultați tabelul de mai jos pentru câteva exemple de resurse și formate de URL-uri pe care să le utilizați pentru a afișa informații despre evenimente folosind JSON.

Enumerați câteva exemple de resurse de administrare împreună cu un exemplu de URL de fișier de evenimente JSON.
Exemplu de tip de resursă	Exemplu de URL
Comandă	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Acest fișier listează `autorul` evenimentelor, informându-vă ce utilizatori au finalizat anumite acțiuni, cum ar fi cine sau ce anume a publicat un produs.
Produs	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Acest fișier listează `autorul` evenimentelor, informându-vă ce utilizatori au finalizat anumite acțiuni, cum ar fi cine sau ce anume a marcat o plată ca fiind achitată.
Magazin	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Acest format de URL afișează cele mai recente 250 de evenimente care au avut loc în magazinul dvs. Evenimentele pot include, fără a se limita la, crearea sau actualizarea de produse, ștergeri de pagini și actualizări de variante.

Pentru o listă completă a resurselor care pot crea evenimente și evenimentele specifice care sunt create pentru fiecare tip de resursă, consultați resursa JSON Eveniment în Documentația pentru dezvoltatori Shopify.