Pristup detaljnim podacima u administratorskom alatu za Shopify pomoću JSON-a

JSON, skraćenica za JavaScript Object Notation, format je za pohranu i prijenos podataka koji se često upotrebljava kada se podaci šalju s poslužitelja na internetske stranice. Na većini stranica resursa u administratorskom alatu za Shopify, poput stranica Narudžbe, Proizvodi ili Korisnici, možete pristupiti detaljnijim podacima pomoću JSON-a.

Iako se od vas ne traži izvođenje naprednih razvojnih zadataka pomoću JSON-a, mogućnost pristupa JSON datoteci za određeni resurs u administratorskom alatu za Shopify može vam pomoći prikupiti detaljnije informacije, kao i u samostalnom rješavanju problema te analizi. Na primjer, možete pregledati JSON datoteku proizvoda da biste pronašli ID njegove varijante, što može biti potrebno za određene zadatke migracije podataka ili prilagodbe koda teme. Drugi je primjer da se možete osloniti na JSON datoteku narudžbe kako biste potvrdili varijablu podataka koju želite upotrijebiti prilikom izrade automatiziranog tijeka rada u aplikaciji Shopify Flow.

JSON najčešće upotrebljavaju programeri, ali čak i korisnici s ograničenim znanjem kodiranja mogu imati koristi od učenja o tome kako pronaći i protumačiti neke uobičajene JSON informacije u administratorskom alatu za Shopify.

Na ovoj stranici

Ponovno formatiranje JSON datoteke

Neobrađeni JSON podaci prikazuju se kao dugi niz ugniježđenih varijabli i zagrada, što je korisnicima teško čitljivo.

Kako biste JSON formatiranje učinili čitljivijim, razmotrite bilo koju od sljedećih opcija:

Instalirajte proširenje za prikaz JSON-a u svoj preglednik.
Upotrijebite mogućnost za optimizaciju prikaza koda (pretty-print) koja je u većini modernih internetskih preglednika zadana postavka:

Snimka zaslona JSON datoteke proizvoda s prikazanim primjernim informacijama o proizvodu. Postavka potvrdnog okvira za „pretty-print” je aktivna i istaknuta u gornjem lijevom kutu stranice.

Pristup JSON datotekama u administratorskom alatu za Shopify

Administratorski alat za Shopify glavno je središte za upravljanje svim aspektima vašeg poslovanja te je osmišljen za standardni prikaz samo najkorisnijih i najvažnijih informacija. Dodatne informacije koje se prikupljaju kad god se radnje izvode u vašoj administratorskoj ploči pohranjuju se u datoteke .json na različitim stranicama resursa. Ti se dodatni detalji ne prikazuju prema zadanim postavkama jer bi ta količina informacija bila prevelika i nekorisna, a upotrebu vaše administratorske ploče učinila bi otežanom.

Za većinu poslovnih zadataka možete upotrijebiti postojeće alate platforme Shopify kako biste pristupili informacijama o svojoj trgovini i protumačili ih. Međutim, povremeno može biti korisno pregledati specifične informacije o određenim resursima, poput proizvoda ili narudžbi, prilikom rješavanja problema s time zašto se ili kada nešto dogodilo.

Primjer: Pristup JSON datoteci narudžbe

U ovom ćete primjeru pristupiti JSON datoteci narudžbe u administratorskom alatu za Shopify.

Koraci:

U administratorskom alatu za Shopify idite na Narudžbe.
Kliknite na bilo koju narudžbu na popisu Narudžbe.
U adresnu traku preglednika dodajte .json na kraj URL adrese. Izgledat će slično ovom primjeru:

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

Pritisnite Enter kako biste ponovno učitali stranicu u JSON formatu.
Neobavezno: Ako u pregledniku nemate instalirano proširenje za prikaz JSON-a, aktivirajte postavku Pretty-print u pregledniku kako biste JSON datoteku učinili preglednijom. Saznajte više o ponovnom formatiranju JSON datoteke.

Primijetit ćete da se prikazuje mnogo očekivanih informacija o narudžbi, kao što su "currency" i "line_items" povezani s narudžbom, no uključeno je i puno drugih detaljnih informacija, poput svojstva "client_details" iz sesije preglednika korisnika kada su napravili narudžbu. Ovakva vrsta informacija korisna je za općenito praćenje sesija i analitiku marketinške platforme, no nije vam neophodna za obradu narudžbe.

Prikaz specifičnih polja u JSON datoteci

Možete prisilno postaviti JSON datoteke na prikaz samo specifičnih polja, što može olakšati tumačenje informacija ako znate konkretna svojstva koja želite uključiti. Na kraj URL-a bilo koje JSON datoteke u adresnoj traci preglednika dodajte ?fields=, a zatim uključite nazive svojstava koja želite prikazati, bilo kojim redoslijedom, odvojene zarezom.

Na primjer, za prikaz ID-ja narudžbe, informacija o korisniku, ukupne cijene i oznaka, dodajte ?fields=id,customer,total_price,tags na kraj URL-a JSON datoteke, kao u sljedećem primjeru:

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

Upotreba drugih JSON resursa

Sljedeće JSON resurse možete upotrijebiti za prikaz specifičnih informacija u administratorskom alatu za Shopify:

Broj proizvoda: Dodajte /count.json na kraj URL-a popisa Proizvodi kako bi se prikazao ukupan broj proizvoda. Cijeli URL trebao bi biti:

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

Transakcije: Dodajte /transactions.json na kraj URL-a stranice narudžbe za prikaz isključivo informacija o transakciji narudžbe. Saznajte više o resursu Transactions.
Ispunjenja: Dodajte /fulfillments.json na kraj URL-a stranice narudžbe za prikaz isključivo informacija o ispunjenju narudžbe. Saznajte više o resursu Fulfillment.
Nezavršena plaćanja: Dodajte .json na kraj URL-a nezavršenog plaćanja za prikaz detaljnih informacija o nezavršenom plaćanju. Saznajte više o resursu Abandoned checkout.

Uobičajena JSON svojstva za rješavanje problema

U sljedećoj su tablici navedena JSON svojstva koja vam mogu pomoći pri rješavanju problema s različitim vrstama resursa. Na primjer, ako želite provjeriti kada je određeni proizvod objavljen, u JSON datoteci proizvoda možete pregledati svojstvo published_at koje prikazuje datum i vrijeme u formatu ISO 8601.

Ova tablica ne uključuje svaki mogući JSON resurs ili svojstvo pohranjeno u administratorskom alatu za Shopify, pa potražite definicije za sve resurse i svojstva koja ovdje nisu navedena u dokumentaciji za razvojne programere za platformu Shopify.

Sadrži primjere nekih administratorskih resursa i uobičajenih svojstava povezanih s njima, uključujući definicije namjene pri rješavanju problema.
Resurs	JSON svojstvo	Definicija
Proizvod	`"product": { "created_at"`	Vrijeme i datum početne izrade proizvoda.
	`"product": { "published_at"`	Vrijeme i datum kada je status proizvoda postavljen na Aktivno.
	`"product": { "updated_at"`	Najnovije vrijeme i datum kada je proizvod ažuriran. To može uključivati promjene opisa proizvoda, naslova ili informacija o SEO-u, kao i automatska ažuriranja poput promjena na zalihama prilikom kupnje proizvoda.
Varijanta	`"product": { "variants": [ { "created_at"`	Vrijeme i datum početne izrade varijante. Može se razlikovati od datuma i vremena izrade samog proizvoda.
	`"product": { "variants": [ { "updated_at"`	Najnovije vrijeme i datum kada je varijanta ažurirana. Može se razlikovati od datuma i vremena posljednjeg ažuriranja samog proizvoda.
	`"product": { "variants": [ { "inventory_quantity"`	Trenutačna vrijednost u bazi podataka i onoga što je dostupno korisnicima za kupnju. Ovo može biti negativna vrijednost ako se zalihe varijante ne prate ili je omogućeno prodavanje veće količine od dostupne.
	`"product": { "variants": [ { "old_inventory_quantity"`	Vrijednost u bazi podataka prije datuma posljednjeg ažuriranja `updated_at` varijante.
Narudžba	`"order": { "line_items": [ { "requires_shipping"`	Prikazuje se kao `true` ili `false`. Označava postavke dostave proizvoda ili varijante u vrijeme izvršavanja narudžbe.
	`"order": { "line_items": [ { "taxable"`	Prikazuje se kao `true` ili `false`. Označava kako je proizvod ili varijanta postavljena za naplatu poreza u vrijeme izvršavanja narudžbe.
	`"order": { "line_items": [ { "variant_inventory_management"`	Prikazuje se kao `shopify`, `amazon_marketplace_web`, `null` ili vrijednost treće strane, ovisno o tome koja je usluga ispunjavanja narudžbi postavljena za praćenje zaliha proizvoda. Vrijednost `null` znači da se proizvod nije pratio u vrijeme narudžbe.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Prikazuje koliko je zaliha sustav još rezervirao kako bi dovršio narudžbu. To nije jednako trenutačnoj zalihi varijante.
	`"order": { "line_items": [ { "quantity"`	Broj kupljenih proizvoda ili varijanti.
	`"order": { "line_items": [ { "tax_lines"`	U SAD-u se prikazuju vrijednosti za saveznu državu, okrug i općinu. Ako se ne prikazuju porezne stavke, ali je na narudžbu naplaćen porez, to znači da je porez naplaćen na trošak dostave.
Korisnik	`"customer": { "created_at"`	Vrijeme i datum početne izrade korisnika.
Korisnik	`"customer": { "updated_at"`	Najnovije vrijeme i datum kada je profil korisnika ažuriran.

Metapolja u formatu JSON

Metapolja su fleksibilan način dodavanja prilagođenih informacija resursima na platformi Shopify, kao što su proizvodi ili kolekcije. Neki primjeri podataka pohranjenih pomoću metapolja uključuju specifikacije proizvoda, tablice veličina, dokumente za preuzimanje, datume izdavanja, slike ili brojeve dijelova. Saznajte više o upotrebi metapolja.

Možete dodati /metafields.json na kraj URL-a podržane stranice resursa za prikaz metapolja koja su povezana s tim resursom. Pogledajte sljedeću tablicu za neke primjere resursa i formata URL-ova koji se koriste za prikaz informacija o metapoljima s pomoću formata JSON.

Popis nekih primjera administratorskih resursa uz primjer URL-a JSON datoteke metapolja.
Primjer vrste resursa	Primjer URL-a
Pametna kolekcija	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Korisnik	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Narudžba	`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 za slike proizvoda mogu se dodati isključivo putem API-ja. Zamijenite `{id}` i ostala rezervirana mjesta u URL-u stvarnim vrijednostima iz vaših API upita.
Trgovina	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Cjelovit popis resursa koji mogu imati metapolja i specifične vrste svojstava koja se pohranjuju za svaku vrstu resursa potražite pod stavkom resurs Metafield JSON u dokumentaciji za razvojne programere za platformu Shopify.

Događaji u formatu JSON

Neki resursi na platformi Shopify generiraju događaje kada se dovrše određene radnje, kao što je izrada objave na blogu, ispunjenje narudžbe ili dodavanje proizvoda.

Možete dodati /events.json na kraj URL-a podržane stranice resursa za prikaz događaja povezanih s tim resursom. Pogledajte sljedeću tablicu za neke primjere resursa i formata URL-ova koji se upotrebljavaju za prikaz informacija o događajima u formatu JSON.

Navedite neke primjere administratorskih resursa uz primjer URL-a datoteke događaja u formatu JSON.
Primjer vrste resursa	Primjer URL-a
Narudžba	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` U ovoj se datoteci navodi `author` događaja, što vam pruža informacije o tome koji su korisnici izvršili određene radnje, primjerice tko ili što je objavilo proizvod.
Proizvod	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` U ovoj se datoteci navodi `author` događaja, što vam pruža informacije o tome koji su korisnici izvršili određene radnje, primjerice tko ili što je označilo plaćanje kao plaćeno.
Trgovina	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` U ovom se formatu URL-a prikazuje 250 najnovijih događaja u vašoj trgovini. Događaji, između ostalog, mogu obuhvaćati izradu ili ažuriranja proizvoda, brisanja stranica te ažuriranja varijanti.

Potpuni popis resursa koji mogu izraditi događaje te specifičnih događaja koji se izrađuju za svaku vrstu resursa potražite u odjeljku Event JSON resource u dokumentaciji za razvojne programere platforme Shopify.