Dostop do podrobnih podatkov v skrbniku Shopify z uporabo datotek JSON

JSON (okrajšava za JavaScript Object Notation) je format za shranjevanje in prenos podatkov, ki se pogosto uporablja pri pošiljanju podatkov s strežnikov na spletne strani. Na večini strani z viri v skrbniku Shopify, kot so strani Naročila, Izdelki ali Stranke, lahko z uporabo formata JSON dostopate do podrobnejših podatkov.

Čeprav vam ni treba izvajati naprednih razvojnih nalog s formatom JSON, vam lahko dostop do datoteke JSON za določen vir v skrbniku Shopify pomaga zbrati podrobnejše informacije ali pa sami odpravite oziroma raziščete težave. Na primer, lahko pregledate datoteko JSON za izdelek, da poiščete njegov ID različice, ki je lahko potreben za določena opravila prenašanja podatkov ali prilagajanja kode teme. Kot drug primer si lahko ogledate datoteko JSON naročila in potrdite podatkovno spremenljivko, ki jo želite uporabiti pri ustvarjanju avtomatiziranega poteka dela v aplikaciji Shopify Flow.

JSON najpogosteje uporabljajo razvijalci, vendar lahko tudi uporabnikom z omejenim znanjem kodiranja koristi, če se naučijo poiskati in interpretirati nekatere pogoste informacije v formatu JSON v skrbniku Shopify.

Na tej strani

Preoblikovanje datoteke JSON

Surovi podatki JSON so prikazani kot dolgo zaporedje ugnezdenih spremenljivk in oklepajev, kar je za človeškega uporabnika težko berljivo.

Za boljšo berljivost formata JSON razmislite o kateri koli od teh možnosti:

V brskalnik namestite razširitev za pregledovalnik JSON.
Uporabite zmožnost lepega tiska (pretty-print), ki je privzeto na voljo v večini sodobnih spletnih brskalnikov:

Screenshot of a JSON product file with example product information displayed. The

Dostop do datotek JSON v skrbniku Shopify

Skrbnik Shopify je osrednje središče za upravljanje vseh vidikov vašega poslovanja in je zasnovan tako, da privzeto prikazuje samo najbolj uporabne in ustrezne informacije. Dodatne informacije, ki se zberejo ob izvajanju dejanj v skrbniku, so shranjene v datotekah .json različnih strani z viri. Te dodatne podrobnosti vam privzeto niso prikazane, ker bi bila takšna količina informacij prevelika in neuporabna ter bi otežila uporabo skrbnika.

Za večino poslovnih nalog lahko uporabite obstoječa orodja storitve Shopify za dostop do informacij o vaši trgovini in njihovo interpretacijo. Kljub temu je včasih pri odpravljanju težav (zakaj ali kdaj se je nekaj zgodilo) koristno pregledati specifične informacije o določenih virih, kot so izdelki ali naročila.

Primer: dostop do datoteke JSON naročila

V tem primeru boste dostopali do datoteke JSON naročila v skrbniku Shopify.

Koraki:

V skrbniku Shopify pojdite na Naročila.
Kliknite poljubno naročilo na seznamu Naročila.
V naslovni vrstici brskalnika dodajte .json na konec URL-naslova. Podobno bo temu primeru:

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

Pritisnite Enter, da znova naložite stran v formatu JSON.
Izbirno: Če v brskalniku nimate nameščene razširitve pregledovalnika JSON, v njem aktivirajte nastavitev Lepi tisk (Pretty-print), da bo datoteka JSON uporabniku prijaznejša. Preberite več informacij o preoblikovanju datoteke JSON.

Opazili boste, da se prikaže veliko pričakovanih informacij o naročilu, kot sta "currency" in "line_items", povezanih z naročilom, vključenih pa je tudi veliko drugih podrobnih informacij, kot je "client_details" iz seje strankinega brskalnika, ko je oddala naročilo. Tovrstne informacije so uporabne za splošno sledenje sejam in analitiko platforme za trženje, niso pa potrebne za obdelavo in izpolnitev naročila.

Prikaz določenih polj v datoteki JSON

Datoteke JSON lahko prisilite, da prikažejo samo določena polja, kar olajša interpretacijo informacij, če veste, katere lastnosti želite vključiti. Na konec katerega koli URL-naslova datoteke JSON v naslovni vrstici brskalnika dodajte ?fields= in nato vključite imena lastnosti, ki jih želite prikazati, v poljubnem vrstnem redu in ločena z vejico.

Če želite na primer prikazati ID naročila, podatke o stranki, skupno ceno in oznake, na konec URL-naslova datoteke JSON dodajte ?fields=id,customer,total_price,tags, kot je prikazano v naslednjem primeru:

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

Uporaba drugih virov JSON

Za prikaz določenih informacij v skrbniku Shopify lahko uporabite naslednje vire JSON:

Število izdelkov: dodajte /count.json na konec URL-naslova seznama Izdelki, da se prikaže skupno število izdelkov. Celoten URL-naslov bi moral biti:

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

Transakcije: na konec URL-naslova strani naročila dodajte /transactions.json, da prikažete le informacije o transakcijah naročila. Pridobite več informacij o viru transakcij.
Izpolnitve: na konec URL-naslova strani naročila dodajte /fulfillments.json, da prikažete le informacije o izpolnitvah naročila. Pridobite več informacij o viru izpolnitev.
Zapuščene blagajne: na konec URL-naslova zapuščene blagajne dodajte .json, da prikažete podrobne informacije o zapuščeni blagajni. Pridobite več informacij o viru zapuščenih blagajn.

Pogoste lastnosti JSON za odpravljanje težav

V spodnji tabeli so navedene lastnosti JSON, ki vam lahko pomagajo pri odpravljanju težav z različnimi vrstami virov. Če želite na primer preveriti, kdaj je bil določen izdelek objavljen, lahko v datoteki JSON izdelka preverite lastnost published_at, ki prikazuje datum in čas v formatu ISO 8601.

Ta tabela ne vključuje vseh možnih virov ali lastnosti JSON, shranjenih v skrbniku Shopify, zato si za definicije katerega koli vira ali lastnosti, ki tukaj ni vključena, oglejte dokumentacijo za razvijalce za Shopify.

Navaja nekaj primerov skrbniških virov in z njimi povezanih pogostih lastnosti, vključno z definicijami, za kaj se lahko uporabijo pri odpravljanju težav.
Vir	Lastnost JSON	Definicija
Izdelek	`"product": { "created_at"`	Čas in datum, ko je bil izdelek prvotno ustvarjen.
	`"product": { "published_at"`	Čas in datum, ko je bil status izdelka nastavljen na Aktivno.
	`"product": { "updated_at"`	Najnovejši čas in datum posodobitve izdelka. To lahko vključuje spremembe opisa izdelka, naslova ali informacij o SEO, pa tudi samodejne posodobitve, kot so spremembe inventarja ob nakupu izdelka.
Različica	`"product": { "variants": [ { "created_at"`	Čas in datum, ko je bila različica prvotno ustvarjena. To se lahko razlikuje od datuma in časa, ko je bil ustvarjen sam izdelek.
	`"product": { "variants": [ { "updated_at"`	Najnovejši čas in datum posodobitve različice. To se lahko razlikuje od datuma in časa zadnje posodobitve samega izdelka.
	`"product": { "variants": [ { "inventory_quantity"`	Trenutna vrednost v zbirki podatkov in to, kar je strankam na voljo za nakup. To je lahko negativna vrednost, če se inventarju različice ne sledi ali če je nastavljen na prekomerno prodajo.
	`"product": { "variants": [ { "old_inventory_quantity"`	Vrednost v zbirki podatkov pred zadnjim datumom `updated_at` različice.
Naročilo	`"order": { "line_items": [ { "requires_shipping"`	Prikaže se kot `true` ali `false`. To označuje nastavitve pošiljanja za izdelek ali različico v času oddaje naročila.
	`"order": { "line_items": [ { "taxable"`	Prikaže se kot `true` ali `false`. To označuje, kako je bil izdelek ali različica nastavljena za obračunavanje davkov v času oddaje naročila.
	`"order": { "line_items": [ { "variant_inventory_management"`	Prikaže se kot `shopify`, `amazon_marketplace_web`, `null` ali kot vrednost zunanjega izvajalca, odvisno od tega, katero izpolnjevanje naročil strank je nastavljeno za sledenje inventarju izdelka. Vrednost `null` pomeni, da se izdelku v času naročila ni sledilo.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Prikaže, koliko inventarja sistem še vedno rezervira za izpolnitev naročila. To ni enako trenutnemu inventarju različice.
	`"order": { "line_items": [ { "quantity"`	Število kupljenih izdelkov ali različic.
	`"order": { "line_items": [ { "tax_lines"`	V Združenih državah Amerike se prikažejo vrednosti za državo, okrožje in občino. Če vrstice z davki niso prikazane, a je bil na naročilu obračunan davek, to pomeni, da je bil davek obračunan na stroške pošiljanja.
Stranka	`"customer": { "created_at"`	Čas in datum, ko je bila stranka prvotno ustvarjena.
Stranka	`"customer": { "updated_at"`	Najnovejši čas in datum posodobitve profila stranke.

Metapolja v obliki JSON

Metapolja so prilagodljiv način za pripenjanje dodatnih informacij po meri viru v sistemu Shopify, kot so izdelki ali zbirke. Nekaj primerov podatkov, shranjenih z uporabo metapolj, vključuje specifikacije izdelkov, tabele velikosti, prenosljive dokumente, datume izdaj, slike ali številke delov. Pridobite več informacij o uporabi metapolj.

Na konec URL-naslova podprte strani vira lahko dodate /metafields.json, da prikažete metapolja, ki so povezana s tem virom. V spodnji tabeli si oglejte nekaj primerov virov in formatov URL-naslovov za prikaz informacij o metapoljih z uporabo oblike JSON.

Prikazuje nekaj primerov skrbniških virov skupaj s primerom URL-naslova datoteke z metapolji JSON.
Primer vrste vira	Primer URL-naslova
Pametna zbirka	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Stranka	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Naročilo	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Stran	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Izdelek	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Različica	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Slika izdelka	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Opomba: metapolja za slike izdelkov lahko dodate samo prek API-ja. V URL-naslovu zamenjajte `{id}` in druga nadomestna besedila z dejanskimi vrednostmi iz svojih poizvedb API.
Trgovina	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Za popoln seznam virov, ki imajo lahko metapolja, in specifične vrste lastnosti, ki so shranjene za vsako vrsto vira, si oglejte vir metapolj JSON v dokumentaciji za razvijalce za Shopify.

Dogodki v obliki JSON

Nekateri viri sistema Shopify generirajo dogodke ob zaključku določenih dejanj, kot je ustvarjanje objave v spletnem dnevniku, izpolnitev naročila ali dodajanje izdelka.

Na konec URL-naslova podprte strani vira lahko dodate /events.json, da prikažete dogodke, povezane s tem virom. V spodnji tabeli si oglejte nekaj primerov virov in formatov URL-naslovov za prikaz informacij o dogodkih v obliki JSON.

V nadaljevanju je nekaj primerov virov skrbniške plošče skupaj s primerom URL-naslova datoteke z dogodki v obliki JSON.
Primer vrste vira	Primer URL-naslova
Naročilo	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` V tej datoteki je naveden `author` dogodkov, iz katerega lahko razberete, kateri uporabniki so izvedli določena dejanja, na primer kdo ali kaj je objavilo izdelek.
Izdelek	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` V tej datoteki je naveden `author` dogodkov, iz katerega lahko razberete, kateri uporabniki so izvedli določena dejanja, na primer kdo ali kaj je plačilo označilo kot plačano.
Trgovina	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Ta oblika URL-naslova prikazuje 250 najnovejših dogodkov v vaši trgovini. Dogodki lahko med drugim vključujejo ustvarjanje ali posodobitve izdelkov, brisanje strani in posodobitve različic.

Za celoten seznam virov, ki lahko ustvarijo dogodke, in določenih dogodkov, ki so ustvarjeni za posamezno vrsto vira, si oglejte Event JSON resource v dokumentaciji za razvijalce za Shopify.