Piekļuve detalizētiem datiem Shopify administratora panelī, izmantojot JSON

JSON (saīsinājums no JavaScript Object Notation) ir datu glabāšanas un pārsūtīšanas formāts, ko bieži izmanto, kad dati tiek nosūtīti no serveriem uz tīmekļa lapām. Lielākajā daļā resursu lapu Shopify administratora panelī, piemēram, lapās Pasūtījumi, Produkti vai Klienti, vari piekļūt detalizētākiem datiem, izmantojot JSON.

Lai gan tev nav jāveic sarežģīti izstrādes uzdevumi, izmantojot JSON, iespēja piekļūt noteikta resursa JSON failam Shopify administratora panelī var palīdzēt apkopot detalizētāku informāciju vai pašam novērst vai izpētīt problēmas. Piemēram, vari pārskatīt produkta JSON failu, lai atrastu tā varianta ID, kas var būt nepieciešams noteiktiem datu migrācijas uzdevumiem vai tēmas koda pielāgošanai. Kā vēl vienu piemēru var minēt atsaukšanos uz pasūtījuma JSON failu, lai apstiprinātu datu mainīgo, ko vēlies izmantot, veidojot automatizētu darbplūsmu programmā Shopify Flow.

Visbiežāk JSON izmanto izstrādātāji, bet arī lietotāji ar nelielām programmēšanas zināšanām var gūt labumu, iemācoties atrast un interpretēt biežāk izmantoto JSON informāciju savā Shopify administratora panelī.

Šajā lapā

JSON faila pārformatēšana

Neapstrādāti JSON dati tiek parādīti kā gara ligzdotu mainīgo un iekavu virkne, kuru cilvēkam ir grūti izlasīt.

Lai padarītu JSON formatējumu lasāmāku, apsver kādu no šīm opcijām:

Instalē pārlūkprogrammā JSON skatītāja paplašinājumu.
Izmanto formāta uzlabošanas (pretty-print) iespēju, kas vairumā mūsdienu tīmekļa pārlūkprogrammu ir pieejama pēc noklusējuma:

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

Piekļuve JSON failiem Shopify administratora panelī

Shopify administratora panelis ir galvenā vieta visu uzņēmējdarbības aspektu pārvaldībai un ir izstrādāts tā, lai pēc noklusējuma parādītu tikai noderīgāko un atbilstošāko informāciju. Papildinformācija, kas tiek apkopota ikreiz, kad tavā administratora panelī tiek veiktas darbības, tiek saglabāta dažādu resursu lapu .json failos. Šī papildu informācija tev pēc noklusējuma netiek rādīta, jo šāds informācijas daudzums būtu pārmērīgs, nederīgs un padarītu administratora paneli grūti lietojamu.

Lielākajai daļai uzņēmējdarbības uzdevumu vari izmantot Shopify esošos rīkus, lai piekļūtu sava veikala informācijai un interpretētu to. Tomēr dažkārt var būt noderīgi pārskatīt specifisku informāciju par konkrētiem resursiem, piemēram, produktiem vai pasūtījumiem, kad tiek novērstas problēmas saistībā ar to, kāpēc vai kad kaut kas notika.

Piemērs: piekļuve pasūtījuma JSON failam

Šajā piemērā tu piekļūsi pasūtījuma JSON failam savā Shopify administratora panelī.

Darbības:

Sava Shopify administratora paneļa sadaļā dodies uz Pasūtījumi.
Sarakstā Pasūtījumi noklikšķini uz jebkura pasūtījuma.
Pārlūkprogrammas adreses joslā URL adreses beigās pievieno .json. Tā būs līdzīga šim piemēram:

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

Nospied Enter, lai atkārtoti ielādētu lapu JSON formātā.
Pēc izvēles: ja tavā pārlūkprogrammā nav instalēts JSON skatītāja paplašinājums, aktivizē pārlūkprogrammā iestatījumu Pretty-print, lai padarītu JSON failu lietotājam draudzīgāku. Uzzini vairāk par JSON faila pārformatēšanu.

Tu pamanīsi, ka tiek parādīta liela daļa paredzamās informācijas par pasūtījumu, piemēram, ar pasūtījumu saistītā "currency" un "line_items", bet ir iekļauta arī cita detalizēta informācija, piemēram, "client_details" no klienta pārlūkprogrammas sesijas, kad klients veica pasūtījumu. Šāda informācija ir noderīga vispārējai sesiju izsekošanai un mārketinga platformas analītikai, taču tā nav nepieciešama pasūtījuma apstrādei un izpildei.

Konkrētu lauku parādīšana JSON failā

Vari iestatīt, lai JSON failos tiktu rādīti tikai noteikti lauki, tādējādi atvieglojot informācijas interpretāciju, ja zini konkrētus rekvizītus, kurus vēlies iekļaut. Jebkura JSON faila URL adreses beigās pārlūkprogrammas adreses joslā pievieno ?fields= un pēc tam, atdalot ar komatu, jebkurā secībā iekļauj to rekvizītu nosaukumus, kurus vēlies parādīt.

Piemēram, lai parādītu pasūtījuma ID, informāciju par klientu, kopējo cenu un tagus, JSON faila URL beigās pievieno ?fields=id,customer,total_price,tags, kā norādīts tālāk esošajā piemērā:

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

Citu JSON resursu izmantošana

Lai parādītu specifisku informāciju savā Shopify administratora panelī, vari izmantot tālāk norādītos JSON resursus:

Produktu skaits: Produktu saraksta URL beigās pievieno /count.json, lai parādītu kopējo produktu skaitu. Pilnajam URL ir jābūt šādam:

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

Darījumi: pasūtījuma lapas URL beigās pievieno /transactions.json, lai parādītu tikai informāciju par pasūtījuma darījumu. Uzzini vairāk par darījumu resursiem.
Izpildes: pasūtījuma lapas URL beigās pievieno /fulfillments.json, lai parādītu tikai pasūtījuma izpildes informāciju. Uzzini vairāk par izpildes resursiem.
Pamestie pirkumi: pamestā norēķina URL beigās pievieno .json, lai parādītu detalizētu informāciju par pamesto norēķinu. Uzzini vairāk par pamesto norēķinu resursiem.

Biežāk izmantotie JSON rekvizīti problēmu novēršanai

Tālāk esošajā tabulā ir norādīti JSON rekvizīti, uz kuriem varēsi atsaukties, lai gūtu palīdzību dažādu resursu tipu problēmu novēršanā. Piemēram, ja vēlies apstiprināt, kad konkrēts produkts tika publicēts, vari pārskatīt produkta JSON failu, lai atrastu rekvizītu published_at, kas parāda datumu un laiku ISO 8601 formātā.

Šajā tabulā nav iekļauti visi iespējamie Shopify administratora panelī saglabātie JSON resursi vai rekvizīti, tādēļ jebkura šeit neiekļautā resursa vai rekvizīta definīcijas skati Shopify izstrādātāju dokumentācijā.

Tajā ir norādīti daži administratora paneļa resursu piemēri un ar tiem saistītās biežāk izmantotās īpašības, tostarp to lietojuma definīcijas, kas var noderēt problēmu novēršanā.
Resurss	JSON īpašība	Definīcija
Produkts	`"product": { "created_at"`	Laiks un datums, kad produkts tika sākotnēji izveidots.
	`"product": { "published_at"`	Laiks un datums, kad produkta statuss tika iestatīts kā Aktīvs.
	`"product": { "updated_at"`	Jaunākais laiks un datums, kad produkts tika atjaunināts. Tas var ietvert izmaiņas produkta aprakstā, nosaukumā vai SEO informācijā, kā arī automātiskus atjauninājumus, piemēram, krājumu izmaiņas pēc produkta pirkuma.
Variants	`"product": { "variants": [ { "created_at"`	Laiks un datums, kad variants tika sākotnēji izveidots. Tas var atšķirties no visa produkta izveides datuma un laika.
	`"product": { "variants": [ { "updated_at"`	Jaunākais laiks un datums, kad variants tika atjaunināts. Tas var atšķirties no datuma un laika, kad pēdējo reizi tika atjaunināts viss produkts.
	`"product": { "variants": [ { "inventory_quantity"`	Pašreizējā datubāzes vērtība un klientiem iegādei pieejamais daudzums. Tā var būt negatīva vērtība, ja varianta krājumi netiek izsekoti vai ja ir iestatīts virspārdot.
	`"product": { "variants": [ { "old_inventory_quantity"`	Datubāzes vērtība pirms varianta pēdējā `updated_at` datuma.
Pasūtījums	`"order": { "line_items": [ { "requires_shipping"`	Tiek parādīts kā `true` vai `false`. Tas norāda produkta vai varianta piegādes iestatījumus pasūtījuma veikšanas brīdī.
	`"order": { "line_items": [ { "taxable"`	Tiek parādīts kā `true` vai `false`. Tas norāda, kā produktam vai variantam pasūtījuma veikšanas brīdī bija iestatīta nodokļu aprēķināšana.
	`"order": { "line_items": [ { "variant_inventory_management"`	Tiek parādīts kā `shopify`, `amazon_marketplace_web`, `null` vai trešās puses vērtība atkarībā no tā, kurš pasūtījumu izpildes pakalpojums ir iestatīts produkta krājumu izsekošanai. Vērtība `null` nozīmē, ka produkts pasūtījuma veikšanas brīdī netika izsekots.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Parāda, cik daudz krājumu sistēma vēl ir rezervējusi, lai izpildītu pasūtījumu. Tas nav vienāds ar pašreizējiem varianta krājumiem.
	`"order": { "line_items": [ { "quantity"`	Iegādāto produktu vai variantu skaits.
	`"order": { "line_items": [ { "tax_lines"`	Amerikas Savienotajās Valstīs šeit tiek parādītas štatu, apgabalu un pašvaldību vērtības. Ja nodokļu rindas netiek parādītas, bet pasūtījumam tika piemērots nodoklis, tas nozīmē, ka nodoklis tika aprēķināts no sūtīšanas izmaksām.
Klients	`"customer": { "created_at"`	Laiks un datums, kad klients tika sākotnēji izveidots.
Klients	`"customer": { "updated_at"`	Jaunākais laiks un datums, kad tika atjaunināts klienta profils.

Metalauki JSON formātā

Metalauki ir elastīgs veids, kā pievienot pielāgotu papildinformāciju Shopify resursam, piemēram, produktiem vai kolekcijām. Daži izmantojot metalaukus saglabāto datu piemēri ir produktu specifikācijas, izmēru tabulas, lejupielādējami dokumenti, izlaišanas datumi, attēli vai detaļu numuri. Uzzini vairāk par metalauku izmantošanu.

Tu vari pievienot /metafields.json atbalstīta resursu lapas URL beigās, lai parādītu metalaukus, kas ir saistīti ar šo resursu. Skati tālāk esošo tabulu, kurā norādīti daži resursu un URL formātu piemēri, ko izmantot metalauku informācijas attēlošanai JSON formātā.

Dažu administratora paneļa resursu un JSON metalauku failu URL piemēri.
Resursa veida piemērs	URL piemērs
Kolekcija	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Klients	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Pasūtījums	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Lapa	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Produkts	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Variants	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Produkta attēls	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Piezīme. Produktu attēlu metalaukus var pievienot tikai ar API. Aizstāj `{id}` un citus vietturus URL adresē ar atbilstošajām vērtībām no saviem API vaicājumiem.
Veikals	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Lai iegūtu pilnu to resursu sarakstu, kuriem var būt metalauki, un konkrētus katram resursu veidam saglabāto īpašību veidus, skati Metafield JSON resursu Shopify izstrādātāju dokumentācijā.

Events JSON formātā

Daži Shopify resursi ģenerē Events pēc noteiktu darbību pabeigšanas, piemēram, pēc emuāra ieraksta izveides, pasūtījuma izpildes vai produkta pievienošanas.

Tu vari pievienot /events.json atbalstīta resursa lapas URL beigās, lai parādītu ar šo resursu saistītos Events. Skati tālāk esošo tabulu, kurā norādīti daži resursu un URL formātu piemēri, ko izmantot Events informācijas attēlošanai JSON formātā.

Dažu administratora paneļa resursu un JSON Events failu URL piemēri.
Resursa veida piemērs	URL piemērs
Pasūtījums	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Šajā failā ir norādīts Events `author` (autors), sniedzot informāciju par to, kuri lietotāji ir veikuši noteiktas darbības, piemēram, kurš vai kas ir publicējis produktu.
Produkts	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Šajā failā ir norādīts Events `author` (autors), sniedzot informāciju par to, kuri lietotāji ir veikuši noteiktas darbības, piemēram, kurš vai kas ir atzīmējis maksājumu kā apmaksātu.
Veikals	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Šis URL formāts parāda 250 nesenākos tavā veikalā notikušos Events. Events var ietvert (bet ne tikai) produktu izveidi vai atjauninājumus, lapu dzēšanu un variantu atjauninājumus.

Lai iegūtu pilnu sarakstu ar resursiem, kas var izveidot Events, un ar konkrētiem Events, kas tiek izveidoti katram resursu veidam, skati Event JSON resursu Shopify izstrādātāju dokumentācijā.