Részletes adatok elérése a Shopify adminisztrációs felületén JSON használatával

A JSON, a JavaScript Object Notation rövidítése, egy adat tárolására és továbbítására szolgáló formátum, amelyet gyakran használnak, amikor adatokat küldenek a szerverekről a weblapokra. A Shopify adminisztrációs felületének legtöbb erőforrásoldalán, például a Rendelések, a Termékek vagy az Ügyfelek oldalon a JSON használatával részletesebb adatokhoz férhet hozzá.

Bár a JSON használatával nem kell haladó fejlesztési feladatokat végeznie, a Shopify adminisztrációs felületén egy adott erőforrás JSON-fájljához való hozzáférés segíthet részletesebb információkat gyűjteni, vagy saját maga elhárítani vagy kivizsgálni a problémákat. Például áttekintheti egy termék JSON-fájlját, hogy megtalálja annak változat azonosítóját, amely bizonyos adatmigrációs feladatokhoz vagy a téma kódjának testreszabásához szükséges lehet. Egy másik példa, hogy hivatkozhat egy rendelés JSON-fájljára, hogy megerősítse az adatváltozót, amelyet egy automatizált munkafolyamat létrehozásakor szeretne használni a Shopify Flow-ban.

A JSON-t leggyakrabban a fejlesztők használják, de a korlátozott programozási ismeretekkel rendelkező felhasználók számára is hasznos lehet, ha megtanulják, hogyan találhatnak meg és értelmezhetnek néhány gyakori JSON-információt a Shopify adminisztrációs felületükön.

Ezen az oldalon

JSON-fájl újraformázása

A nyers JSON-adatok egymásba ágyazott változók és zárójelek hosszú sorozataként jelennek meg, ami egy emberi felhasználó számára nehezen olvasható.

A JSON formátum olvashatóbbá tételéhez vegye fontolóra a következő lehetőségek valamelyikét:

Telepítsen egy JSON-megjelenítő bővítményt a böngészőjében.
Használja a legtöbb modern webböngészőben alapértelmezetten elérhető „pretty-print” funkciót:

Képernyőkép egy JSON-termékfájlról, amelyen példa termékinformációk láthatók. A „pretty-print” jelölőnégyzet beállítása aktív, kiemelve az oldal bal felső sarkában.

JSON-fájlok elérése a Shopify adminisztrációs felületén

A Shopify adminisztrációs felülete a vállalkozás minden aspektusának kezelésére szolgáló központi felület, és úgy van kialakítva, hogy alapértelmezetten csak a leghasznosabb és legrelevánsabb információkat jelenítse meg. Az extra információk, amelyeket az adminisztrációs felületen végrehajtott műveletek során gyűjt a rendszer, a különböző erőforrásoldalak .json fájljaiban tárolódnak. Ezek az extra részletek alapértelmezetten nem jelennek meg, mert ez az információmmennyiség túlterhelő és haszontalan lenne, és megnehezítené az adminisztrációs felület használatát.

A legtöbb üzleti feladathoz használhatja a Shopify meglévő eszközeit az áruház adatainak eléréséhez és értelmezéséhez. Időnként azonban hasznos lehet áttekinteni bizonyos erőforrásokkal, például termékekkel vagy rendelésekkel kapcsolatos konkrét információkat, amikor azt vizsgálja, hogy mi vagy mikor történt.

Példa: Egy rendelés JSON-fájljának elérése

Ebben a példában egy rendelés JSON-fájlját fogja elérni a Shopify adminisztrációs felületén.

Lépések:

A Shopify adminisztrációs felületén lépjen a Rendelések oldalra.
Kattintson egy tetszőleges rendelésre a Rendelések listában.
A böngésző címsorában adja hozzá a .json végződést az URL-cím végéhez. A következő példához hasonló lesz:

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

Nyomja le az Enter billentyűt az oldal JSON formátumban való újratöltéséhez.
Opcionális: Ha nincs telepítve JSON-megjelenítő bővítmény a böngészőjében, akkor aktiválja a Pretty-print beállítást a böngészőjében, hogy a JSON-fájl felhasználóbarátabb legyen. További információ: JSON-fájl újraformázása.

Észre fogja venni, hogy a rendelésről rengeteg várt információ megjelenik, például a rendeléshez tartozó "currency" és "line_items", de sok más részletes információ is szerepel benne, például a "client_details" a vásárló böngésző-munkamenetéből, amikor a rendelést leadta. Ez a fajta információ hasznos az általános munkamenet-követéshez és a marketingplatformok elemzéseihez, de nem szükséges a rendelés feldolgozásához és teljesítéséhez.

Adott mezők megjelenítése egy JSON-fájlban

A JSON-fájlokat kényszerítheti arra, hogy csak bizonyos mezőket jelenítsenek meg, ami megkönnyítheti az információk értelmezését, ha tudja, hogy mely tulajdonságokat szeretné belefoglalni. Bármely JSON-fájl URL-címének végén a böngésző címsorában adja hozzá a ?fields= részt, majd vesszővel elválasztva, tetszőleges sorrendben adja meg a megjeleníteni kívánt tulajdonságneveket.

Például egy rendelés azonosítójának, vásárlói adatainak, végösszegének és címkéinek megjelenítéséhez adja hozzá a ?fields=id,customer,total_price,tags részt a JSON-fájl URL-címének végéhez, ahogyan az alábbi példában is látható:

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

Más JSON-erőforrások használata

A következő JSON-erőforrásokat használhatja konkrét információk megjelenítésére a Shopify adminisztrációs felületén:

Termékek száma: Adja hozzá a /count.json végződést a Terméklista URL-jének végéhez a termékek teljes számának megjelenítéséhez. A teljes URL-nek a következőnek kell lennie:

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

Tranzakciók: Adja hozzá a /transactions.json végződést egy rendelési oldal URL-jének végéhez, hogy csak a rendelés tranzakciós adatait jelenítse meg. További információ a Tranzakciók erőforrásról.
Teljesítések: Adja hozzá a /fulfillments.json végződést egy rendelési oldal URL-jének végéhez, hogy csak a rendelés teljesítési adatait jelenítse meg. További információ a Teljesítés erőforrásról.
Elhagyott pénztárak: Adja hozzá a .json végződést egy elhagyott pénztár URL-jének végéhez, hogy részletes információkat jelenítsen meg az elhagyott pénztárról. További információ az Elhagyott pénztár erőforrásról.

Gyakori JSON-tulajdonságok hibaelhárításhoz

Az alábbi táblázat felsorolja azokat a JSON-tulajdonságokat, amelyekre a különböző erőforrástípusok hibaelhárítása során szüksége lehet. Ha például meg szeretné tudni, hogy egy adott terméket mikor tettek közzé, akkor megtekintheti a termék JSON-fájljában a published_at tulajdonságot, amely a dátumot és az időt ISO 8601 formátumban jeleníti meg.

Ez a táblázat nem tartalmazza a Shopify adminisztrációs felületén tárolt összes lehetséges JSON-erőforrást vagy tulajdonságot, ezért az itt nem szereplő erőforrások vagy tulajdonságok definícióiért tekintse meg a Shopify fejlesztői dokumentációját.

Felsorol néhány példát az adminisztrációs felület erőforrásaira és a hozzájuk tartozó gyakori tulajdonságokra, beleértve azoknak a definícióit is, amelyek a hibaelhárítás során felhasználhatók.
Erőforrás	JSON-tulajdonság	Meghatározás
Termék	`"product": { "created_at"`	A termék eredeti létrehozásának ideje és dátuma.
	`"product": { "published_at"`	A termék Aktív állapotra állításának ideje és dátuma.
	`"product": { "updated_at"`	A termék legutóbbi frissítésének ideje és dátuma. Ez magában foglalhatja a termékleírás, a cím vagy a keresőoptimalizálási információk módosítását, valamint az automatikus frissítéseket, például a készlet változását egy termék megvásárlásakor.
Változat	`"product": { "variants": [ { "created_at"`	A változat eredeti létrehozásának ideje és dátuma. Ez eltérhet a teljes termék létrehozási dátumától és idejétől.
	`"product": { "variants": [ { "updated_at"`	A változat legutóbbi frissítésének ideje és dátuma. Ez eltérhet a teljes termék legutóbbi frissítésének dátumától és idejétől.
	`"product": { "variants": [ { "inventory_quantity"`	Az aktuális adatbázis-érték, amely a vásárlók számára megvásárlásra elérhető. Ez az érték negatív is lehet, ha a változat készletkövetése nincs engedélyezve, vagy ha túlértékesítésre van beállítva.
	`"product": { "variants": [ { "old_inventory_quantity"`	Az adatbázis-érték a változat legutóbbi `updated_at` dátuma előtti állapot szerint.
Rendelés	`"order": { "line_items": [ { "requires_shipping"`	`true` vagy `false` értékként jelenik meg. Ez jelzi a termék vagy változat szállítási beállításait a rendelés leadásának időpontjában.
	`"order": { "line_items": [ { "taxable"`	`true` vagy `false` értékként jelenik meg. Ez azt jelzi, hogy a termékre vagy változatra hogyan lett beállítva az adó felszámítása a rendelés leadásának időpontjában.
	`"order": { "line_items": [ { "variant_inventory_management"`	`shopify`, `amazon_marketplace_web`, `null` vagy egy harmadik féltől származó értékként jelenik meg, attól függően, hogy melyik teljesítési szolgáltatás van beállítva a termék készletének követésére. A `null` érték azt jelenti, hogy a termék készletkövetése nem volt aktív a rendelés időpontjában.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Azt mutatja, hogy a rendszer mennyi készletet tart még lefoglalva a rendelés teljesítéséhez. Ez nem egyezik meg a változat aktuális készletével.
	`"order": { "line_items": [ { "quantity"`	A megvásárolt termékek vagy változatok száma.
	`"order": { "line_items": [ { "tax_lines"`	Az Egyesült Államokban ez állami, megyei és települési értékeket jelenít meg. Ha nem jelennek meg adósorok, de a rendelésre adót számítottak fel, akkor ez azt jelenti, hogy az adót a szállítási költségre számították fel.
Ügyfél	`"customer": { "created_at"`	A vásárló eredeti létrehozásának ideje és dátuma.
Ügyfél	`"customer": { "updated_at"`	A vásárlóprofil legutóbbi frissítésének ideje és dátuma.

Metamezők JSON formátumban

A metamezők rugalmas módot kínálnak további egyéni információk csatolására egy Shopify-erőforráshoz, például termékekhez vagy kollekciókhoz. A metamezők használatával tárolt adatokra néhány példa: termékspecifikációk, mérettáblázatok, letölthető dokumentumok, kiadási dátumok, képek vagy cikkszámok. További információ a metamezők használatáról.

Hozzáadhatja a /metafields.json szöveget egy támogatott erőforrásoldal URL-címének végéhez, hogy megjelenítse az adott erőforráshoz társított metamezőket. Az alábbi táblázatban példákat talál az erőforrásokra és az URL-formátumokra, amelyek segítségével JSON formátumban jelenítheti meg a metamezők adatait.

Néhány példa adminisztrációs erőforrás és a hozzájuk tartozó JSON metamezőfájl-URL.
Példa erőforrástípus	Példa URL
Okos kollekció	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Vásárló	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Rendelés	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Oldal	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Termék	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Változat	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Termékkép	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Megjegyzés: A termékkép-metamezők csak az API-n keresztül adhatók hozzá. Cserélje ki az `{id}` és egyéb helyőrzőket az URL-ben az API-lekérdezésekből származó tényleges értékekkel.
Üzlet	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

A metamezőkkel rendelkező erőforrások teljes listájáért, valamint az egyes erőforrástípusokhoz tárolt tulajdonságok konkrét típusaiért tekintse meg a Metamező JSON-erőforrást a Shopify fejlesztői dokumentációjában.

Események JSON formátumban

Eseményeket bizonyos Shopify-erőforrások hoznak létre, amikor bizonyos műveletek befejeződnek, például egy blogbejegyzés létrehozásakor, egy rendelés teljesítésekor vagy egy termék hozzáadásakor.

Hozzáadhatja az /events.json szöveget egy támogatott erőforrásoldal URL-címének végéhez, hogy megjelenítse az adott erőforráshoz társított eseményeket. Az alábbi táblázatban példákat talál az erőforrásokra és az URL-formátumokra, amelyek segítségével JSON formátumban jelenítheti meg az események adatait.

Néhány példa adminisztrációs erőforrás és a hozzájuk tartozó JSON eseményfájl-URL.
Példa erőforrástípus	Példa URL
Rendelés	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Ez a fájl felsorolja az események `author` (szerző) mezőjét, tájékoztatva arról, hogy mely felhasználók hajtottak végre bizonyos műveleteket, például ki vagy mi tette közzé a terméket.
Termék	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Ez a fájl felsorolja az események `author` (szerző) mezőjét, tájékoztatva arról, hogy mely felhasználók hajtottak végre bizonyos műveleteket, például ki vagy mi jelölte a fizetést fizetettnek.
Üzlet	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Ez az URL-formátum az üzletében történt 250 legutóbbi eseményt jeleníti meg. Az események közé tartozhat például a termék létrehozása vagy frissítése, az oldalak törlése és a változatok frissítése.

Az eseményeket létrehozni képes erőforrások teljes listájáért, valamint az egyes erőforrástípusokhoz létrehozott konkrét eseményekért tekintse meg az Esemény JSON-erőforrást a Shopify fejlesztői dokumentációjában.