Prístup k podrobným údajom v administrátorovi Shopify pomocou formátu JSON

JSON (skratka pre JavaScript Object Notation) je formát na ukladanie a prenos údajov. Často sa používa pri odosielaní údajov zo serverov na webové stránky. Na väčšine stránok so zdrojmi v administrátorovi Shopify, ako sú napríklad stránky Objednávky, Produkty alebo Zákazníci, máte prístup k podrobnejším údajom pomocou formátu JSON.

Aj keď sa od vás nevyžaduje vykonávanie pokročilých vývojárskych úloh pomocou formátu JSON, prístup k súboru JSON pre konkrétny zdroj v administrátorovi Shopify vám môže pomôcť získať podrobnejšie informácie alebo samostatne riešiť a skúmať problémy. Môžete napríklad skontrolovať súbor JSON pre produkt, aby ste našli jeho ID variantu, čo sa môže vyžadovať pri určitých úlohách migrácie údajov alebo prispôsobovaní kódu témy. Ako ďalší príklad si môžete pozrieť súbor JSON objednávky na potvrdenie premennej údajov, ktorú chcete použiť pri vytváraní automatizovaného pracovného postupu v aplikácii Shopify Flow.

Formát JSON najčastejšie používajú vývojári, ale aj používatelia s obmedzenými znalosťami kódovania môžu získať výhody z toho, že sa naučia, ako nájsť a interpretovať niektoré bežné informácie vo formáte JSON vo svojom administrátorovi Shopify.

Na tejto stránke

Preformátovanie súboru JSON

Nespracované údaje JSON sa zobrazujú ako dlhá sekvencia vnorených premenných a zátvoriek, čo je pre používateľa ťažko čitateľné.

Ak chcete, aby bol formát JSON čitateľnejší, zvážte niektorú z nasledujúcich možností:

Nainštalujte si do prehliadača rozšírenie na zobrazenie formátu JSON.
Použite schopnosť formátovaného zobrazenia (pretty-print), ktorú má väčšina moderných webových prehliadačov predvolene k dispozícii:

Snímka obrazovky súboru JSON produktu so zobrazenými vzorovými informáciami o produkte. Nastavenie začiarkavacieho políčka „pretty-print“ je aktívne a zvýraznené v ľavej hornej časti stránky.

Prístup k súborom JSON v administrátorovi Shopify

Administrátor Shopify je centrálnym uzlom na spravovanie všetkých aspektov vášho podnikania a je navrhnutý tak, aby predvolene zobrazoval iba tie najužitočnejšie a najrelevantnejšie informácie. Dodatočné informácie, ktoré sa zhromažďujú pri každom vykonaní akcií v administrátorovi, sa ukladajú do súborov .json na rôznych stránkach zdrojov. Tieto dodatočné podrobnosti sa predvolene nezobrazujú, pretože takéto množstvo informácií by bolo neprehľadné, neužitočné a sťažilo by používanie administrátora.

Na väčšinu obchodných úloh môžete použiť existujúce nástroje Shopify na prístup k informáciám o vašom obchode a ich interpretáciu. Niekedy však môže byť užitočné preštudovať si konkrétne informácie o určitých zdrojoch, ako sú produkty alebo objednávky, pri riešení problémov, prečo alebo kedy sa niečo stalo.

Príklad: Prístup k súboru JSON objednávky

V tomto príklade pristúpite k súboru JSON objednávky v administrátorovi Shopify.

Kroky:

V administrátorovi Shopify prejdite na Objednávky.
Kliknite na ľubovoľnú objednávku v zozname Objednávky.
Do panela s adresou v prehliadači pridajte .json na koniec adresy URL. Bude to vyzerať podobne ako v tomto príklade:

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

Stlačením klávesu Enter znova načítajte stránku vo formáte JSON.
Voliteľné: Ak v prehliadači nemáte nainštalované rozšírenie na zobrazenie formátu JSON, aktivujte v ňom nastavenie Pretty-print, aby bol súbor JSON používateľsky prívetivejší. Prečítajte si ďalšie informácie o preformátovaní súboru JSON.

Všimnite si, že sa zobrazuje veľa očakávaných informácií o objednávke, napríklad "currency" a "line_items" spojené s objednávkou, ale zahrnuté je aj množstvo ďalších podrobných informácií, napríklad "client_details" z relácie prehliadača zákazníka, v ktorom zadal objednávku. Tento druh informácií je užitočný na celkové sledovanie relácií a analytiku marketingových platforiem, ale nie je potrebný na spracovanie a vybavenie objednávky.

Zobrazenie špecifických polí v súbore JSON

Súbory JSON môžete prinútiť, aby zobrazovali iba špecifické polia, čo môže zjednodušiť interpretáciu informácií, ak poznáte konkrétne vlastnosti, ktoré chcete zahrnúť. Na koniec akejkoľvek adresy URL súboru JSON v paneli s adresou v prehliadači pridajte ?fields= a potom zadajte názvy vlastností, ktoré chcete zobraziť, v ľubovoľnom poradí a oddelené čiarkou.

Ak chcete napríklad zobraziť ID objednávky, informácie o zákazníkoch, celkovú cenu a štítky, na koniec adresy URL súboru JSON pridajte ?fields=id,customer,total_price,tags, ako napríklad v nasledujúcom príklade:

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

Používanie iných zdrojov JSON

Nasledujúce zdroje JSON môžete použiť na zobrazenie konkrétnych informácií v administrátorovi Shopify:

Počet produktov: Pridaním parametra /count.json na koniec adresy URL zoznamu Produkty sa zobrazí celkový počet produktov. Úplná adresa URL by mala byť:

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

Transakcie: Pridajte /transactions.json na koniec adresy URL stránky objednávky, aby sa zobrazili len informácie o transakciách objednávky. Ďalšie informácie o zdroji transakcií.
Naplnenia: Pridajte /fulfillments.json na koniec adresy URL stránky objednávky, aby sa zobrazili len informácie o naplnení objednávky. Ďalšie informácie o zdroji naplnení.
Opustené pokladne: Pridajte .json na koniec adresy URL opustenej pokladne, aby sa zobrazili podrobné informácie o opustenej pokladni. Ďalšie informácie o zdroji opustených pokladní.

Bežné vlastnosti JSON na riešenie problémov

Nasledujúca tabuľka uvádza vlastnosti JSON, ktoré by ste mohli potrebovať pri riešení problémov s rôznymi typmi zdrojov. Ak napríklad chcete potvrdiť, kedy bol konkrétny produkt publikovaný, môžete v súbore JSON produktu skontrolovať vlastnosť published_at, ktorá zobrazuje dátum a čas vo formáte ISO 8601.

Táto tabuľka neobsahuje všetky možné zdroje ani vlastnosti JSON uložené v administrátorovi Shopify. Definície akéhokoľvek zdroja alebo vlastnosti, ktoré tu nie sú uvedené, nájdete v dokumentácii pre vývojárov platformy Shopify.

Uvádza niekoľko vzorových administrátorských zdrojov a bežných vlastností, ktoré sú s nimi spojené, vrátane definícií toho, na čo by sa mohli použiť pri riešení problémov.
Zdroj	Vlastnosť JSON	Definícia
Produkt	`"product": { "created_at"`	Čas a dátum pôvodného vytvorenia produktu.
	`"product": { "published_at"`	Čas a dátum zmeny stavu produktu na Aktívny.
	`"product": { "updated_at"`	Najnovší čas a dátum aktualizácie produktu. To môže zahŕňať zmeny opisu produktu, názvu alebo informácií o SEO, ako aj automatické aktualizácie, napríklad zmeny inventára pri zakúpení produktu.
Variant	`"product": { "variants": [ { "created_at"`	Čas a dátum pôvodného vytvorenia variantu. Môže sa líšiť od dátumu a času vytvorenia samotného produktu.
	`"product": { "variants": [ { "updated_at"`	Najnovší čas a dátum aktualizácie variantu. Môže sa líšiť od dátumu a času poslednej aktualizácie samotného produktu.
	`"product": { "variants": [ { "inventory_quantity"`	Aktuálna hodnota v databáze, ktorá je prístupná zákazníkom na nákup. Môže to byť záporná hodnota, ak sa nesleduje inventár variantu, prípadne ak je nastavený nadpredaj.
	`"product": { "variants": [ { "old_inventory_quantity"`	Hodnota v databáze pred posledným dátumom `updated_at` variantu.
Objednávka	`"order": { "line_items": [ { "requires_shipping"`	Zobrazuje sa ako `true` alebo `false`. Označuje nastavenia dopravy pre produkt alebo variant v čase zadania objednávky.
	`"order": { "line_items": [ { "taxable"`	Zobrazuje sa ako `true` alebo `false`. Označuje, ako bol produkt alebo variant nastavený na účtovanie daní v čase zadania objednávky.
	`"order": { "line_items": [ { "variant_inventory_management"`	Zobrazuje sa ako `shopify`, `amazon_marketplace_web`, `null` alebo ako hodnota tretej strany v závislosti od toho, ktorá služba plnenia objednávok je nastavená na sledovanie inventára produktu. Hodnota `null` znamená, že produkt nebol v čase zadania objednávky sledovaný.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Zobrazuje, koľko inventára má systém ešte rezervované na dokončenie objednávky. Nerovná sa to aktuálnemu inventáru variantu.
	`"order": { "line_items": [ { "quantity"`	Počet zakúpených produktov alebo variantov.
	`"order": { "line_items": [ { "tax_lines"`	V USA sa tu zobrazujú hodnoty štátu, okresu a mesta. Ak sa nezobrazujú žiadne daňové riadky, no k objednávke bola naúčtovaná daň, znamená to, že daň sa naúčtovala k nákladom na dopravu.
Zákazník	`"customer": { "created_at"`	Čas a dátum pôvodného vytvorenia zákazníka.
Zákazník	`"customer": { "updated_at"`	Najnovší čas a dátum aktualizácie zákazníckeho profilu.

Metapolia v JSON

Metapolia sú flexibilným spôsobom, ako k zdroju v službe Shopify (napríklad k produktom alebo kolekciám) pripojiť ďalšie vlastné informácie. Príklady údajov uložených pomocou metapolí zahŕňajú špecifikácie produktov, tabuľky veľkostí, dokumenty na stiahnutie, dátumy vydania, obrázky alebo čísla dielov. Ďalšie informácie o používaní metapolí.

Na koniec adresy URL podporovanej stránky zdroja môžete pridať reťazec /metafields.json, aby sa zobrazili metapolia priradené k danému zdroju. V nasledujúcej tabuľke nájdete niekoľko príkladov zdrojov a formátov adries URL na zobrazenie informácií z metapolí pomocou JSON.

Uvádza niekoľko vzorových administrátorských zdrojov spolu so vzorovou adresou URL súboru JSON s metapoliami.
Vzorový typ zdroja	Vzorová adresa URL
Inteligentná kolekcia	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Zákazník	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Objednávka	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Stránka	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Produkt	`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`
Obrázok produktu	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Poznámka: Metapolia obrázka produktu je možné pridať iba prostredníctvom rozhrania API. Nahraďte `{id}` a ďalšie zástupné symboly v adrese URL skutočnými hodnotami z vašich dopytov API.
Obchod	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Úplný zoznam zdrojov, ktoré môžu mať metapolia, a špecifické typy vlastností ukladaných pre jednotlivé typy zdrojov nájdete v dokumentácii pre vývojárov platformy Shopify v časti zdroj Metafield JSON.

Udalosti v JSON

Udalosti generujú niektoré zdroje služby Shopify pri dokončení určitých akcií, ako je napríklad vytvorenie blogového príspevku, naplnenie objednávky alebo pridanie produktu.

Na koniec adresy URL podporovanej stránky zdroja môžete pridať reťazec /events.json, aby sa zobrazili udalosti priradené k danému zdroju. V nasledujúcej tabuľke nájdete niekoľko príkladov zdrojov a formátov adries URL na zobrazenie informácií o udalostiach pomocou JSON.

Uveďte niekoľko príkladov administrátorských zdrojov spolu so vzorovou adresou URL súboru udalostí vo formáte JSON.
Vzorový typ zdroja	Vzorová adresa URL
Objednávka	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` V tomto súbore je uvedený atribút udalostí `author`, ktorý vás informuje o tom, ktorí používatelia vykonali určité akcie, napríklad kto alebo čo publikovalo produkt.
Produkt	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` V tomto súbore je uvedený atribút udalostí `author`, ktorý vás informuje o tom, ktorí používatelia vykonali určité akcie, napríklad kto alebo čo označilo platbu ako uhradenú.
Obchod	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Tento formát adresy URL zobrazuje 250 najnovších udalostí, ktoré sa vyskytli vo vašom obchode. Udalosti môžu zahŕňať napríklad vytvorenie alebo aktualizácie produktu, odstránenia stránok a aktualizácie variantov.

Úplný zoznam zdrojov, ktoré dokážu vytvárať udalosti, a konkrétnych udalostí, ktoré sa vytvárajú pre každý typ zdroja, nájdete v časti Zdroj Event vo formáte JSON v dokumentácii platformy Shopify pre vývojárov.