Prieiga prie išsamių duomenų savo „Shopify“ administratoriaus skydelyje naudojant JSON

JSON (sutrumpinimas iš JavaScript Object Notation) yra duomenų saugojimo ir perdavimo formatas, dažnai naudojamas, kai duomenys siunčiami iš serverių į tinklalapius. Daugelyje išteklių puslapių „Shopify“ administratoriaus aplinkoje, pvz., Užsakymai, Produktai arba Klientai, naudodami JSON galite pasiekti išsamesnius duomenis.

Nors JSON nereikia naudoti atliekant sudėtingas programavimo užduotis, galimybė pasiekti konkretaus ištekliaus JSON failą savo „Shopify“ administratoriaus aplinkoje gali padėti Jums surinkti išsamesnę informaciją arba patiems diagnozuoti ir ištirti problemas. Pavyzdžiui, galite peržiūrėti produkto JSON failą, kad rastumėte jo varianto ID, kurio gali prireikti atliekant tam tikras duomenų migracijos užduotis ar temos kodo pritaikymus. Kitas pavyzdys – galite peržiūrėti užsakymo JSON failą, kad patvirtintumėte duomenų kintamąjį, kurį norite naudoti kurdami automatizuotą darbo eigą programėlėje Shopify Flow.

JSON dažniausiai naudoja programuotojai, tačiau net ir ribotų programavimo žinių turintiems naudotojams gali būti naudinga išmokti, kaip rasti ir interpretuoti tam tikrą bendrą JSON informaciją savo „Shopify“ administratoriaus skydelyje.

Šiame puslapyje

JSON failo performatavimas

Neapdoroti JSON duomenys rodomi kaip ilga įdėtųjų kintamųjų ir skliaustų seka, kurią žmogui sunku perskaityti.

Kad JSON formatavimas būtų lengviau skaitomas, apsvarstykite bet kurį iš šių variantų:

Savo naršyklėje įdiekite JSON peržiūros plėtinį.
Naudokite tvarkingo formatavimo funkciją, kurią pagal numatytuosius nustatymus turi dauguma šiuolaikinių naršyklių:

JSON produkto failo ekrano kopija su rodoma pavyzdine produkto informacija. „Tvarkingo formatavimo“ žymimasis langelis yra aktyvus, paryškintas puslapio viršuje, kairėje.

Prieiga prie JSON failų savo „Shopify“ administratoriaus skydelyje

„Shopify“ administratoriaus skydelis yra pagrindinis centras, skirtas valdyti visus Jūsų verslo aspektus, ir yra sukurtas taip, kad pagal numatytuosius nustatymus rodytų tik naudingiausią ir aktualiausią informaciją. Papildoma informacija, kuri surenkama kaskart, kai atliekate veiksmus savo administratoriaus skydelyje, saugoma skirtingų išteklių puslapių .json failuose. Ši papildoma informacija Jums nerodoma pagal numatytuosius nustatymus, nes toks informacijos kiekis būtų per didelis ir nenaudingas, o Jūsų administratoriaus skydelį būtų sunku naudoti.

Daugumai verslo užduočių galite naudoti esamus „Shopify“ įrankius, kad pasiektumėte ir interpretuotumėte savo parduotuvės informaciją. Tačiau kartais gali būti naudinga peržiūrėti konkrečią informaciją apie tam tikrus išteklius, pavyzdžiui, produktus ar užsakymus, kai šalinamos triktys, siekiant išsiaiškinti, kodėl arba kada kas nors įvyko.

Pavyzdys: pasiekite užsakymo JSON failą

Šiame pavyzdyje pasieksite užsakymo JSON failą savo „Shopify“ administratoriaus skydelyje.

Veiksmai:

Savo „Shopify“ administratoriaus aplinkoje eikite į Užsakymai.
Sąraše Užsakymai spustelėkite bet kurį užsakymą.
Naršyklės adreso juostoje URL adreso pabaigoje pridėkite .json. Jis bus panašus į šį pavyzdį:

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

Paspauskite Enter, kad iš naujo įkeltumėte puslapį JSON formatu.
Pasirinktinai: jei naršyklėje neįdiegėte JSON peržiūros plėtinio, įjunkite naršyklės nustatymą Pretty-print, kad JSON failą būtų patogiau skaityti. Sužinokite daugiau apie JSON failo performatavimą.

Pastebėsite, kad rodoma daug laukiamos informacijos apie užsakymą, pavyzdžiui, su užsakymu susijusi „currency“ ir „line_items“, bet taip pat pateikiama ir daug kitos išsamios informacijos, pavyzdžiui, „client_details“ iš kliento naršyklės seanso, kai jis pateikė užsakymą. Tokia informacija yra naudinga bendram seansų stebėjimui ir rinkodaros platformos duomenų analizei, tačiau jos nereikia norint apdoroti ir įvykdyti užsakymą.

Konkrečių laukų rodymas JSON faile

Galite priversti JSON failus rodyti tik konkrečius laukus, todėl bus lengviau interpretuoti informaciją, kai žinote, kurias konkrečias ypatybes norite įtraukti. Bet kurio JSON failo URL pabaigoje naršyklės adreso juostoje pridėkite ?fields= ir tada įtraukite ypatybių pavadinimus, kuriuos norite rodyti, bet kokia tvarka, atskirdami juos kableliu.

Pavyzdžiui, norėdami parodyti užsakymo ID, informaciją apie klientą, bendrą kainą ir žymas, JSON failo URL pabaigoje pridėkite ?fields=id,customer,total_price,tags, kaip parodyta šiame pavyzdyje:

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

Kitų JSON išteklių naudojimas

Galite naudoti šiuos JSON išteklius, kad savo „Shopify“ administratoriaus skydelyje rodytumėte konkrečią informaciją:

Produktų skaičius: prie Produktų sąrašo URL pabaigos pridėkite /count.json, kad būtų parodytas bendras produktų skaičius. Visas URL turėtų būti toks:

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

Operacijos: prie užsakymo puslapio URL pabaigos pridėkite /transactions.json, kad būtų rodoma tik užsakymo operacijų informacija. Sužinokite daugiau apie operacijų išteklių.
Užsakymų įvykdymai: prie užsakymo puslapio URL pabaigos pridėkite /fulfillments.json, kad būtų rodoma tik užsakymo įvykdymo informacija. Sužinokite daugiau apie užsakymo įvykdymo išteklių.
Nebaigti atsiskaitymai: prie nebaigto atsiskaitymo URL pabaigos pridėkite .json, kad būtų rodoma išsami informacija apie nebaigtą atsiskaitymą. Sužinokite daugiau apie nebaigto atsiskaitymo išteklių.

Bendrosios JSON ypatybės trikčių šalinimui

Šioje lentelėje pateikiamos JSON ypatybės, kurias galite naudoti šalinant įvairių tipų išteklių triktis. Pavyzdžiui, jei norite patvirtinti, kada buvo paskelbtas konkretus produktas, galite peržiūrėti produkto JSON failą ir ieškoti ypatybės published_at, kurioje rodoma data ir laikas ISO 8601 formatu.

Šioje lentelėje nurodyti ne visi įmanomi JSON ištekliai ar ypatybės, saugomos „Shopify“ administratoriaus aplinkoje, todėl bet kokių čia neįtrauktų išteklių ar ypatybių apibrėžčių ieškokite „Shopify“ programuotojų dokumentacijoje.

Pateikiami keli administratoriaus išteklių pavyzdžiai ir su jais susijusios bendrosios ypatybės, įskaitant apibrėžimus, kam jos gali būti naudojamos šalinant triktis.
Išteklius	JSON ypatybė	Apibrėžimas
Produktas	`"product": { "created_at"`	Laikas ir data, kada produktas buvo sukurtas.
	`"product": { "published_at"`	Laikas ir data, kada produkto būsena buvo nustatyta kaip Aktyvi.
	`"product": { "updated_at"`	Paskutinis laikas ir data, kada produktas buvo atnaujintas. Tai gali apimti produkto aprašo, pavadinimo ar SEO informacijos pakeitimus, taip pat automatinius atnaujinimus, pavyzdžiui, inventoriaus pokyčius, kai produktas nuperkamas.
Variantas	`"product": { "variants": [ { "created_at"`	Laikas ir data, kada variantas buvo sukurtas. Tai gali skirtis nuo datos ir laiko, kada buvo sukurtas visas produktas.
	`"product": { "variants": [ { "updated_at"`	Paskutinis laikas ir data, kada variantas buvo atnaujintas. Tai gali skirtis nuo datos ir laiko, kada paskutinį kartą buvo atnaujintas visas produktas.
	`"product": { "variants": [ { "inventory_quantity"`	Dabartinė duomenų bazės vertė ir tai, ką klientai gali įsigyti. Tai gali būti neigiama vertė, jei varianto inventorius nėra sekamas arba jei nustatyta parduoti viršijant atsargas.
	`"product": { "variants": [ { "old_inventory_quantity"`	Duomenų bazės vertė iki paskutinės varianto `updated_at` datos.
Užsakymas	`"order": { "line_items": [ { "requires_shipping"`	Rodoma kaip `true` arba `false`. Tai nurodo produkto ar varianto pristatymo nuostatas užsakymo pateikimo metu.
	`"order": { "line_items": [ { "taxable"`	Rodoma kaip `true` arba `false`. Tai nurodo, kaip produktui ar variantui buvo nustatyta taikyti mokesčius užsakymo pateikimo metu.
	`"order": { "line_items": [ { "variant_inventory_management"`	Rodoma kaip `shopify`, `amazon_marketplace_web`, `null` arba trečiosios šalies vertė, atsižvelgiant į tai, kuri įvykdymo paslauga nustatyta sekti produkto inventorių. `null` vertė reiškia, kad užsakymo metu produkto inventorius nebuvo sekamas.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Parodo, kiek inventoriaus sistema vis dar yra rezervavusi, kad būtų įvykdytas užsakymas. Tai nelygu dabartiniam varianto inventoriui.
	`"order": { "line_items": [ { "quantity"`	Įsigytų produktų ar variantų skaičius.
	`"order": { "line_items": [ { "tax_lines"`	Jungtinėse Valstijose čia rodomos valstijos, apygardos ir savivaldybės vertės. Jei mokesčių eilutės nerodomos, bet užsakymui buvo pritaikyti mokesčiai, tai reiškia, kad mokesčiai buvo pritaikyti siuntimo kainai.
Klientas	`"customer": { "created_at"`	Laikas ir data, kada klientas buvo sukurtas.
Klientas	`"customer": { "updated_at"`	Paskutinis laikas ir data, kada kliento profilis buvo atnaujintas.

Metalaukai JSON formatu

Metalaukai yra lankstus būdas pridėti papildomos pasirinktinės informacijos prie „Shopify“ ištekliaus, pvz., produktų ar kolekcijų. Keletas duomenų, saugomų naudojant metalaukus, pavyzdžių: produktų specifikacijos, dydžių lentelės, atsisiunčiami dokumentai, išleidimo datos, vaizdai arba dalių numeriai. Sužinokite daugiau apie metalaukų naudojimą.

Galite pridėti /metafields.json prie palaikomo ištekliaus puslapio URL pabaigos, kad būtų rodomi su tuo ištekliumi susiję metalaukai. Toliau pateiktoje lentelėje rasite keletą išteklių ir URL formatų pavyzdžių, kaip naudojant JSON rodyti metalaukų informaciją.

Pateikiami keli administratoriaus išteklių pavyzdžiai kartu su JSON metalaukų failo URL pavyzdžiu.
Ištekliaus tipo pavyzdys	URL pavyzdys
Išmanioji kolekcija	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Klientas	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Užsakymas	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Puslapis	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Produktas	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Variantas	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Produkto vaizdas	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Pastaba: produktų vaizdų metalaukus galima pridėti tik per API. Pakeiskite `{id}` ir kitas rezervuotas vietas URL adrese faktinėmis reikšmėmis iš savo API užklausų.
Parduotuvė	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Išsamų išteklių, galinčių turėti metalaukų, sąrašą ir konkrečius ypatybių tipus, kurie saugomi kiekvienam išteklių tipui, rasite Metalauko JSON išteklių apraše „Shopify“ programuotojų dokumentacijoje.

Įvykiai JSON formatu

Įvykiai generuojami kai kuriuose „Shopify“ ištekliuose, kai atliekami tam tikri veiksmai, pavyzdžiui, sukuriamas įrašas tinklaraštyje, įvykdomas užsakymas arba pridedamas produktas.

Galite pridėti /events.json prie palaikomo ištekliaus puslapio URL pabaigos, kad būtų rodomi su tuo ištekliumi susiję įvykiai. Toliau pateiktoje lentelėje rasite keletą išteklių ir URL formatų pavyzdžių, kaip naudojant JSON rodyti įvykių informaciją.

Pateikiami keli administratoriaus išteklių pavyzdžiai kartu su JSON įvykių failo URL pavyzdžiu.
Ištekliaus tipo pavyzdys	URL pavyzdys
Užsakymas	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Šiame faile nurodomas įvykių `author`, todėl galite matyti, kurie naudotojai atliko tam tikrus veiksmus, pavyzdžiui, kas paskelbė produktą.
Produktas	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Šiame faile nurodomas įvykių `author`, todėl galite matyti, kurie naudotojai atliko tam tikrus veiksmus, pavyzdžiui, kas pažymėjo mokėjimą kaip apmokėtą.
Parduotuvė	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Šiuo URL formatu rodoma 250 naujausių įvykių, įvykusių Jūsų parduotuvėje. Pavyzdžiui, įvykiai gali būti produktų kūrimas ar atnaujinimas, puslapių naikinimas ir variantų atnaujinimas.

Išsamų išteklių, galinčių kurti įvykius, sąrašą ir konkrečius įvykius, kurie sukuriami kiekvienam išteklių tipui, rasite Įvykio JSON išteklių apraše „Shopify“ programuotojų dokumentacijoje.