Yksityiskohtaisten tietojen tarkasteleminen Shopifyn ohjausnäkymässä JSON-muodossa

JSON, joka on lyhenne sanoista JavaScript Object Notation, on datan tallennus- ja siirtomuoto, jota käytetään usein, kun dataa lähetetään palvelimilta verkkosivuille. Useimmilla Shopifyn ohjausnäkymän resurssisivuilla, kuten Tilaukset-, Tuotteet- tai Asiakkaat-sivuilla, voit tarkastella tarkempia tietoja JSON-muodossa.

Vaikka sinun ei tarvitsekaan suorittaa kehittyneitä kehitystehtäviä JSON:n avulla, tietyn resurssin JSON-tiedoston tarkasteleminen Shopifyn ohjausnäkymässä voi auttaa sinua keräämään tarkempia tietoja tai selvittämään ongelmia itse. Esimerkiksi voit tarkastella tuotteen JSON-tiedostoa löytääksesi sen versiotunnuksen, jota saatetaan tarvita tietyissä datan siirtotehtävissä tai teemakoodin mukautuksissa. Toisena esimerkkinä voit vahvistaa tilauksen JSON-tiedostosta tietomuuttujan, jota haluat käyttää, kun rakennat automatisoitua työnkulkua Shopify Flow'ssa.

JSON-muotoa käyttävät useimmiten kehittäjät, mutta myös käyttäjät, joilla on vain vähän koodaustaitoja, voivat hyötyä siitä, että he oppivat etsimään ja tulkitsemaan joitakin yleisiä JSON-tietoja Shopifyn ohjausnäkymässään.

Tällä sivulla

JSON-tiedoston uudelleenmuotoilu

Raaka JSON-data näkyy pitkänä sisäkkäisten muuttujien ja sulkeiden sarjana, jota ihmisen on vaikea lukea.

Voit parantaa JSON-muotoilun luettavuutta seuraavilla tavoilla:

Asenna selaimeesi JSON-katseluohjelman laajennus.
Käytä pretty-print-ominaisuutta, joka on useimmissa nykyaikaisissa selaimissa oletusarvoisesti käytettävissä:

Kuvakaappaus JSON-tuotetiedostosta, jossa näkyy esimerkkejä tuotetiedoista. ”pretty-print”-valintaruutu on aktiivinen ja korostettu sivun vasemmassa yläkulmassa.

JSON-tiedostojen tarkasteleminen Shopifyn ohjausnäkymässä

Shopifyn ohjausnäkymä on kaikkien liiketoimintasi osa-alueiden hallinnoinnin keskus, ja se on suunniteltu näyttämään oletusarvoisesti vain hyödyllisimmät ja olennaisimmat tiedot. Lisätiedot, joita kerätään aina, kun ohjausnäkymässäsi suoritetaan toimintoja, tallennetaan eri resurssisivujen .json-tiedostoihin. Näitä lisätietoja ei näytetä sinulle oletusarvoisesti, koska tietojen määrä olisi ylivoimainen ja hyödytön ja tekisi ohjausnäkymästäsi vaikeakäyttöisen.

Useimmissa liiketoiminnan tehtävissä voit käyttää Shopifyn olemassa olevia työkaluja kauppasi tietojen tarkasteluun ja tulkintaan. Toisinaan voi kuitenkin olla hyödyllistä tarkastella tiettyjä resursseja, kuten tuotteita tai tilauksia, koskevia tarkkoja tietoja, kun selvitetään, miksi tai milloin jotain tapahtui.

Esimerkki: tilauksen JSON-tiedoston tarkasteleminen

Tässä esimerkissä tarkastelet tilauksen JSON-tiedostoa Shopifyn ohjausnäkymässäsi.

Vaiheet:

Siirry Shopifyn ohjausnäkymässä kohtaan Tilaukset.
Klikkaa mitä tahansa tilausta Tilaukset-luettelosta.
Lisää selaimen osoiterivillä .json URL-osoitteen loppuun. Se on samankaltainen kuin tässä esimerkissä:

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

Lataa sivu uudelleen JSON-muodossa painamalla Enter-näppäintä.
Valinnainen: Jos selaimeesi ei ole asennettu JSON-katseluohjelman laajennusta, aktivoi selaimessasi Pretty-print-asetus, jotta JSON-tiedosto olisi käyttäjäystävällisempi. Lue lisää aiheesta JSON-tiedoston uudelleenmuotoilu.

Huomaat, että näkyviin tulee paljon odotettuja tietoja tilauksesta, kuten tilaukseen liittyvät "currency" ja "line_items", mutta mukana on myös paljon muita yksityiskohtaisia tietoja, kuten "client_details" asiakkaan selainistunnosta, kun hän teki tilauksen. Tällaiset tiedot ovat hyödyllisiä yleisessä istuntojen seurannassa ja markkinointialustan analytiikassa, mutta ne eivät ole välttämättömiä tilauksen käsittelyä ja täyttämistä varten.

Tiettyjen kenttien näyttäminen JSON-tiedostossa

Voit pakottaa JSON-tiedostot näyttämään vain tietyt kentät, mikä voi helpottaa tietojen tulkintaa, kun tiedät, mitkä ominaisuudet haluat sisällyttää. Lisää selaimen osoiterivillä JSON-tiedoston URL-osoitteen loppuun ?fields= ja sen jälkeen pilkulla erotettuina niiden ominaisuuksien nimet, jotka haluat näyttää. Voit lisätä ominaisuudet missä tahansa järjestyksessä.

Jos haluat näyttää esimerkiksi tilauksen tunnuksen, asiakastiedot, kokonaishinnan ja tunnisteet, lisää JSON-tiedoston URL-osoitteen loppuun ?fields=id,customer,total_price,tags seuraavan esimerkin mukaisesti:

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

Muiden JSON-resurssien käyttäminen

Voit käyttää seuraavia JSON-resursseja tiettyjen tietojen näyttämiseen Shopifyn ohjausnäkymässäsi:

Tuotteiden määrä: Lisää /count.json Tuotteet-luettelon URL-osoitteen loppuun nähdäksesi tuotteiden kokonaismäärän. Koko URL-osoitteen tulisi olla:

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

Maksutapahtumat: Lisää /transactions.json tilaussivun URL-osoitteen loppuun, jotta näet vain tilauksen maksutapahtumatiedot. Lue lisää Maksutapahtumat-resurssista.
Tilauksen täyttämiset: Lisää /fulfillments.json tilaussivun URL-osoitteen loppuun, jotta näet vain tilauksen täyttämistiedot. Lue lisää Tilauksen täyttämisresurssista.
Hylätyt kassavaiheet: Lisää .json hylätyn kassavaiheen URL-osoitteen loppuun, jotta näet yksityiskohtaiset tiedot hylätystä kassavaiheesta. Lue lisää Hylätty kassavaihe -resurssista.

Yleisiä JSON-ominaisuuksia vianmääritykseen

Seuraavassa taulukossa on lueteltu JSON-ominaisuuksia, joita voit käyttää apuna eri resurssityyppien vianmäärityksessä. Jos esimerkiksi haluat varmistaa, milloin tietty tuote on julkaistu, voit tarkastella tuotteen JSON-tiedostosta published_at-ominaisuutta, joka näyttää päivämäärän ja kellonajan ISO 8601 -muodossa.

Tämä taulukko ei sisällä kaikkia Shopifyn ohjausnäkymään tallennettuja JSON-resursseja tai -ominaisuuksia. Shopifyn kehittäjäoppaista löydät määritelmät kaikille resursseille ja ominaisuuksille, joita ei ole mainittu tässä.

Luettelee esimerkkejä ohjausnäkymän resursseista ja niihin liittyvistä yleisistä ominaisuuksista sekä niiden määritelmistä ja käyttötarkoituksista vianmäärityksessä.
Resurssi	JSON-ominaisuus	Määritelmä
Tuote	`"product": { "created_at"`	Aika ja päivämäärä, jolloin tuote alun perin luotiin.
	`"product": { "published_at"`	Aika ja päivämäärä, jolloin tuotteen tilaksi asetettiin Aktiivinen.
	`"product": { "updated_at"`	Viimeisin aika ja päivämäärä, jolloin tuote päivitettiin. Tähän voi sisältyä tuotekuvaukseen, nimeen tai SEO-tietoihin tehtyjä muutoksia sekä automaattisia päivityksiä, kuten varaston muutoksia tuotteen ostamisen yhteydessä.
Versio	`"product": { "variants": [ { "created_at"`	Aika ja päivämäärä, jolloin versio alun perin luotiin. Tämä voi poiketa siitä päivämäärästä ja ajasta, jolloin koko tuote luotiin.
	`"product": { "variants": [ { "updated_at"`	Viimeisin aika ja päivämäärä, jolloin versio päivitettiin. Tämä voi poiketa siitä päivämäärästä ja ajasta, jolloin koko tuote viimeksi päivitettiin.
	`"product": { "variants": [ { "inventory_quantity"`	Tietokannan nykyinen arvo ja se, mikä on asiakkaiden ostettavissa. Arvo voi olla negatiivinen, jos version varastoa ei seurata tai jos ylimyynti on sallittu.
	`"product": { "variants": [ { "old_inventory_quantity"`	Tietokannan arvo ennen version viimeisintä `updated_at`-päivämäärää.
Tilaus	`"order": { "line_items": [ { "requires_shipping"`	Näytetään arvona `true` tai `false`. Tämä ilmaisee tuotteen tai version toimitusasetukset tilaushetkellä.
	`"order": { "line_items": [ { "taxable"`	Näytetään arvona `true` tai `false`. Tämä ilmaisee, miten tuotteelle tai versiolle oli määritetty verojen veloitus tilaushetkellä.
	`"order": { "line_items": [ { "variant_inventory_management"`	Näytetään arvona `shopify`, `amazon_marketplace_web`, `null` tai kolmannen osapuolen arvo riippuen siitä, mikä tilausten täyttämisen palvelu on asetettu seuraamaan tuotteen varastoa. Arvo `null` tarkoittaa, että tuotetta ei seurattu tilaushetkellä.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Näyttää, kuinka paljon järjestelmä on vielä varannut varastosta tilauksen loppuunsaattamiseksi. Tämä ei vastaa version nykyistä varastoa.
	`"order": { "line_items": [ { "quantity"`	Ostettujen tuotteiden tai versioiden määrä.
	`"order": { "line_items": [ { "tax_lines"`	Yhdysvalloissa tämä näyttää osavaltion, piirikunnan ja kunnan arvot. Jos verorivejä ei näy, mutta tilauksesta on veloitettu vero, vero on veloitettu toimituskuluista.
Asiakas	`"customer": { "created_at"`	Aika ja päivämäärä, jolloin asiakas alun perin luotiin.
Asiakas	`"customer": { "updated_at"`	Viimeisin aika ja päivämäärä, jolloin asiakasprofiili päivitettiin.

Metakentät JSON-muodossa

Metakentät ovat joustava tapa liittää ylimääräistä mukautettua tietoa Shopifyn resurssiin, kuten tuotteisiin tai kokoelmiin. Esimerkkejä metakenttien avulla tallennetuista tiedoista ovat tuotetiedot, kokotaulukot, ladattavat asiakirjat, julkaisupäivät, kuvat tai osanumerot. Lue lisää metakenttien käytöstä.

Voit lisätä /metafields.json tuetun resurssisivun URL-osoitteen loppuun, jolloin näet kyseiseen resurssiin liittyvät metakentät. Seuraavassa taulukossa on esimerkkejä resursseista ja URL-muodoista, joiden avulla voit näyttää metakenttien tietoja JSON-muodossa.

Luettelo esimerkeistä ohjausnäkymän resursseista ja JSON-metakenttätiedoston URL-esimerkistä.
Esimerkkiresurssi	Esimerkki-URL
Älykäs kokoelma	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Asiakas	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Tilaus	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Sivu	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Tuote	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Versio	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Tuotekuva	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Huomautus: Tuotekuvien metakenttiä voidaan lisätä vain API:n kautta. Korvaa `{id}` ja muut paikkamerkit URL-osoitteessa API-kyselyistäsi saaduilla todellisilla arvoilla.
Kauppa	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Täydellinen luettelo resursseista, joilla voi olla metakenttiä, ja tiedot kunkin resurssityypin tallentamista ominaisuustyypeistä löytyvät Shopifyn kehittäjäoppaiden osiosta Metakenttä-JSON-resurssi.

Tapahtumat JSON-muodossa

Jotkin Shopifyn resurssit luovat tapahtumia, kun tietyt toiminnot on suoritettu, kuten blogipostauksen luominen, tilauksen täyttäminen tai tuotteen lisääminen.

Voit lisätä /events.json tuetun resurssisivun URL-osoitteen loppuun, jolloin näet kyseiseen resurssiin liittyvät tapahtumat. Seuraavassa taulukossa on esimerkkejä resursseista ja URL-muodoista, joiden avulla voit näyttää tapahtumatietoja JSON-muodossa.

Luettelo esimerkeistä ohjausnäkymän resursseista ja JSON-tapahtumatiedoston URL-esimerkistä.
Esimerkkiresurssi	Esimerkki-URL
Tilaus	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Tämä tiedosto luettelee tapahtumien `author`-tiedon, joka kertoo, mitkä käyttäjät ovat suorittaneet tiettyjä toimintoja, kuten kuka tai mikä julkaisi tuotteen.
Tuote	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Tämä tiedosto luettelee tapahtumien `author`-tiedon, joka kertoo, mitkä käyttäjät ovat suorittaneet tiettyjä toimintoja, kuten kuka tai mikä merkitsi maksun maksetuksi.
Kauppa	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Tämä URL-muoto näyttää 250 viimeisintä kaupassasi tapahtunutta tapahtumaa. Tapahtumia voivat olla esimerkiksi tuotteiden luonti tai päivitykset, sivujen poistot ja versioiden päivitykset.

Löydät täydellisen luettelon resursseista, jotka voivat luoda tapahtumia, sekä kunkin resurssityypin luomista tietyistä tapahtumista Shopifyn kehittäjän oppaiden Event JSON -resurssi -kohdasta.