Pristup detaljnim podacima u Shopify adminu pomoću JSON-a

JSON, skraćenica od JavaScript Object Notation, je format za skladištenje i prenos podataka, koji se često koristi kada se podaci šalju sa servera na veb-stranice. Na većini stranica sa resursima u Shopify adminu, kao što su stranice Porudžbine, Proizvodi ili Kupci, možete da pristupite detaljnijim podacima koristeći JSON.

Iako niste obavezni da obavljate napredne razvojne zadatke koristeći JSON, mogućnost da pristupite JSON datoteci za određeni resurs u Shopify adminu može vam pomoći da prikupite detaljnije informacije ili da sami rešavate i istražujete probleme. Na primer, možete da pregledate JSON datoteku za proizvod da biste pronašli njegov ID varijante, što može biti potrebno za određene zadatke prebacivanja podataka ili prilagođavanja koda teme. Drugi primer je da možete pogledati JSON datoteku porudžbine da biste potvrdili promenljivu podataka koju želite da koristite prilikom kreiranja automatizovanog toka posla u aplikaciji Shopify Flow.

JSON najčešće koriste programeri, ali čak i korisnici sa ograničenim znanjem kodiranja mogu imati koristi od učenja kako da pronađu i protumače neke uobičajene JSON informacije u svom Shopify adminu.

Na ovoj stranici

Preoblikovanje formata JSON datoteke

Neobrađeni JSON podaci se prikazuju kao dugačak niz ugnježdenih promenljivih i zagrada, što je korisnicima teško da pročitaju.

Da bi formatiranje JSON-a bilo čitljivije, razmotrite bilo koju od sledećih opcija:

Instalirajte ekstenziju za pregled JSON-a u svom pregledaču.
Koristite funkciju pretty-print koja je standardno dostupna u većini modernih veb-pregledača:

Snimak ekrana JSON datoteke proizvoda na kom su prikazane probne informacije o proizvodu. Podešavanje polja za potvrdu „pretty-print“ je aktivno i istaknuto u gornjem levom uglu stranice.

Pristup JSON datotekama u Shopify adminu

Shopify admin je centralno mesto za upravljanje svim aspektima vašeg poslovanja i dizajniran je tako da podrazumevano prikazuje samo najkorisnije i najrelevantnije informacije. Dodatne informacije koje se prikupljaju svaki put kada se preduzmu radnje u vašem adminu čuvaju se u .json datotekama različitih stranica sa resursima. Ovi dodatni detalji se ne prikazuju podrazumevano jer bi ta količina informacija bila preobimna i nekorisna i otežala bi vam korišćenje admina.

Za većinu poslovnih zadataka možete da koristite postojeće Shopify alate da biste pristupili informacijama o svojoj prodavnici i protumačili ih. Međutim, povremeno može biti korisno da pregledate specifične informacije o određenim resursima, kao što su proizvodi ili porudžbine, prilikom rešavanja problema u vezi sa tim zašto ili kada se nešto dogodilo.

Primer: Pristup JSON datoteci porudžbine

U ovom primeru pristupaćete JSON datoteci porudžbine u Shopify adminu.

Koraci:

U Shopify adminu idite na Porudžbine.
Kliknite na bilo koju porudžbinu na listi Porudžbine.
U traci za adresu u pregledaču, dodajte .json na kraj URL adrese. To će izgledati slično ovom primeru:

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

Pritisnite Enter da biste ponovo učitali stranicu u JSON formatu.
Opcionalno: Ako nemate instaliranu ekstenziju za pregled JSON-a u pregledaču, aktivirajte podešavanje Pretty-print u pregledaču da bi JSON datoteka bila prilagođenija korisniku. Saznajte više o preoblikovanju formata JSON datoteke.

Primetićete da se prikazuje mnogo očekivanih informacija o porudžbini, kao što su "currency" i "line_items" koje su povezane sa porudžbinom, ali je uključeno i mnoštvo drugih detaljnih informacija, kao što su "client_details" iz sesije pregledača kupca kada je izvršio porudžbinu. Ova vrsta informacija je korisna za celokupno praćenje sesija i analitiku marketinške platforme, ali vam nije neophodna da biste obradili i realizovali porudžbinu.

Prikazivanje određenih polja u JSON datoteci

Možete primorati JSON datoteke da prikazuju samo određena polja, što može olakšati tumačenje informacija kada znate tačno koja svojstva želite da uključite. Na kraju bilo kog URL-a JSON datoteke u traci za adresu u pregledaču, dodajte ?fields=, a zatim unesite imena svojstava koja želite da prikažete, bilo kojim redosledom, odvojena zarezom.

Na primer, da biste prikazali ID porudžbine, informacije o kupcu, ukupnu cenu i oznake, dodajte ?fields=id,customer,total_price,tags na kraj URL-a JSON datoteke, kao u sledećem primeru:

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

Korišćenje drugih JSON resursa

Možete da koristite sledeće JSON resurse za prikazivanje specifičnih informacija u Shopify adminu:

Broj proizvoda: Dodajte /count.json na kraj URL-a liste Proizvodi da biste prikazali ukupan broj proizvoda. Ceo URL bi trebalo da bude:

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

Transakcije: Dodajte /transactions.json na kraj URL-a stranice porudžbine da biste prikazali samo informacije o transakcijama porudžbine. Saznajte više o resursu Transakcije.
Realizacije: Dodajte /fulfillments.json na kraj URL-a stranice porudžbine da biste prikazali samo informacije o realizaciji porudžbine. Saznajte više o resursu Realizacija.
Napuštene kupovine: Dodajte .json na kraj URL-a napuštene naplate da biste prikazali detaljne informacije o napuštenoj naplati. Saznajte više o resursu Napuštena naplata.

Uobičajena JSON svojstva za rešavanje problema

Sledeća tabela navodi JSON svojstva na koja možete da se pozovete za pomoć pri rešavanju problema sa različitim vrstama resursa. Na primer, ako želite da potvrdite kada je određeni proizvod objavljen, možete pregledati JSON datoteku proizvoda i potražiti svojstvo published_at, koje prikazuje datum i vreme u formatu ISO 8601.

Ova tabela ne uključuje svaki mogući JSON resurs ili svojstvo koje se čuva u Shopify adminu, pa pogledajte Shopify dokumentaciju za programere za definicije bilo kog resursa ili svojstva koje nije ovde uključeno.

Navodi neke primere admin resursa i uobičajena svojstva povezana s njima, uključujući definicije za šta bi mogli da se koriste pri rešavanju problema.
Resurs	Svojstvo u JSON formatu	Definicija
Proizvod	`"product": { "created_at"`	Vreme i datum kada je proizvod prvobitno kreiran.
	`"product": { "published_at"`	Vreme i datum kada je status proizvoda postavljen na Aktivan.
	`"product": { "updated_at"`	Najnovije vreme i datum kada je proizvod ažuriran. To može da uključuje promene opisa proizvoda, naslova ili SEO informacija, kao i automatska ažuriranja poput promene zaliha kada se proizvod kupi.
Varijanta	`"product": { "variants": [ { "created_at"`	Vreme i datum kada je varijanta prvobitno kreirana. To može da se razlikuje od datuma i vremena kada je kreiran celokupan proizvod.
	`"product": { "variants": [ { "updated_at"`	Najnovije vreme i datum kada je varijanta ažurirana. To može da se razlikuje od datuma i vremena kada je celokupan proizvod poslednji put ažuriran.
	`"product": { "variants": [ { "inventory_quantity"`	Trenutna vrednost u bazi podataka i ono što je dostupno kupcima za kupovinu. To može da bude negativna vrednost ako se zalihe varijante ne prate ili ako je podešena prekomerna prodaja.
	`"product": { "variants": [ { "old_inventory_quantity"`	Vrednost u bazi podataka pre poslednjeg datuma `updated_at` varijante.
Porudžbina	`"order": { "line_items": [ { "requires_shipping"`	Prikazuje se kao `true` ili `false`. Ovo ukazuje na podešavanja isporuke proizvoda ili varijante u trenutku kreiranja porudžbine.
	`"order": { "line_items": [ { "taxable"`	Prikazuje se kao `true` ili `false`. Ovo ukazuje na to kako je proizvod ili varijanta bila podešena za naplatu poreza u trenutku kreiranja porudžbine.
	`"order": { "line_items": [ { "variant_inventory_management"`	Prikazuje se kao `shopify`, `amazon_marketplace_web`, `null` ili vrednost treće strane u zavisnosti od toga koja je usluga realizacije porudžbina podešena da prati zalihe proizvoda. Vrednost `null` znači da se proizvod nije pratio u trenutku porudžbine.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Prikazuje koliko je zaliha sistem rezervisao da bi završio porudžbinu. Ovo nije jednako trenutnim zalihama varijante.
	`"order": { "line_items": [ { "quantity"`	Broj kupljenih proizvoda ili varijanti.
	`"order": { "line_items": [ { "tax_lines"`	U Sjedinjenim Državama ovo prikazuje vrednosti za saveznu državu, okrug i opštinu. Ako se ne prikazuju stavke poreza, ali je na porudžbinu naplaćen porez, to znači da je porez naplaćen na troškove dostave.
Kupac	`"customer": { "created_at"`	Vreme i datum kada je kupac prvobitno kreiran.
Kupac	`"customer": { "updated_at"`	Najnovije vreme i datum kada je profil kupca ažuriran.

Metapolja u JSON formatu

Metapolja su fleksibilan način za dodavanje dodatnih prilagođenih informacija Shopify resursu, poput proizvoda ili kolekcija. Neki primeri podataka uskladištenih pomoću metapolja uključuju specifikacije proizvoda, tabele veličina, dokumente za preuzimanje, datume izdavanja, slike ili brojeve delova. Saznajte više o korišćenju metapolja.

Možete da dodate /metafields.json na kraj URL-a stranice podržanog resursa kako bi se prikazala metapolja povezana s tim resursom. Pogledajte sledeću tabelu za neke primere resursa i URL formata koje možete da koristite za prikaz informacija o metapoljima pomoću JSON formata.

Lista nekih primera admin resursa s primerom URL-a JSON datoteke metapolja.
Primer tipa resursa	Primer URL-a
Kolekcija	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Kupac	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Porudžbina	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Stranica	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Proizvod	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Varijanta	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Slika proizvoda	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Napomena: Metapolja slika proizvoda mogu da se dodaju isključivo preko API-ja. Zamenite `{id}` i druge čuvare mesta u URL-u stvarnim vrednostima iz API upita.
Prodavnica	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Za kompletnu listu resursa koji mogu da imaju metapolja, kao i za specifične tipove svojstava koja se čuvaju za svaki tip resursa, pogledajte Metafield JSON resurs u dokumentaciji za programere na platformi Shopify.

Događaji u JSON formatu

Događaje generišu određeni Shopify resursi po završetku nekih radnji, poput kreiranja blog posta, realizacije porudžbine ili dodavanja proizvoda.

Možete da dodate /events.json na kraj URL-a stranice podržanog resursa kako bi se prikazali događaji povezani s tim resursom. Pogledajte sledeću tabelu za neke primere resursa i URL formata koje možete da koristite za prikaz informacija o događajima pomoću JSON formata.

Lista nekih primera admin resursa s primerom URL-a JSON datoteke događaja.
Primer tipa resursa	Primer URL-a
Porudžbina	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Ova datoteka navodi vrednost `author` događaja (autor) i pruža informacije o tome koji su korisnici izvršili određene radnje, na primer ko ili šta je objavilo proizvod.
Proizvod	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Ova datoteka navodi vrednost `author` događaja i pruža informacije o tome koji su korisnici izvršili određene radnje, na primer ko ili šta je označilo plaćanje kao plaćeno.
Prodavnica	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Ovaj URL format prikazuje 250 najnovijih događaja koji su se desili u vašoj prodavnici. Događaji mogu da obuhvataju, između ostalog, kreiranje ili ažuriranja proizvoda, brisanja stranica i ažuriranja varijanti.

Za kompletnu listu resursa koji mogu da kreiraju događaje i za specifične događaje koji se kreiraju za svaki tip resursa, pogledajte Event JSON resurs u dokumentaciji za programere na platformi Shopify.