Få tilgang til detaljerte data i Shopify-administrator ved hjelp av JSON

JSON, en forkortelse for JavaScript Object Notation, er et format for lagring og transport av data, som ofte brukes når data sendes fra servere til nettsider. På de fleste ressurssider i Shopify-administratoren, som for eksempel sidene Bestillinger, Produkter eller Kunder, kan du få tilgang til mer detaljerte data ved hjelp av JSON.

Selv om du ikke trenger å utføre avanserte utviklingsoppgaver ved hjelp av JSON, kan det å ha tilgang til JSON-filen for en bestemt ressurs i Shopify-administratoren hjelpe deg med å samle inn mer detaljert informasjon, eller feilsøke eller undersøke problemer selv. Du kan for eksempel se gjennom JSON-filen for et produkt for å finne variant-ID-en, som kan være nødvendig for visse datamigreringsoppgaver eller tilpasninger av temakode. Et annet eksempel er at du kan se i en bestillings JSON-fil for å bekrefte datavariabelen du vil bruke når du bygger en automatisert arbeidsflyt i Shopify Flow.

JSON brukes oftest av utviklere, men selv brukere med begrenset kodekunnskap kan ha nytte av å lære hvordan man finner og tolker vanlig JSON-informasjon i Shopify-administrator.

På denne siden

Omformatere en JSON-fil

Rå JSON-data vises som en lang sekvens av nestede variabler og parenteser, noe som er utfordrende for et menneske å lese.

Vurder ett av følgende alternativer for å gjøre JSON-formateringen mer lesbar:

Installer en utvidelse for JSON-visning i nettleseren.
Bruk funksjonaliteten for «pretty-print» som de fleste moderne nettlesere har tilgjengelig som standard:

Skjermbilde av en JSON-produktfil som viser eksempel på produktinformasjon. Avkrysningsboksen «pretty-print» er aktiv, og uthevet øverst til venstre på siden.

Få tilgang til JSON-filer i Shopify-administrator

Shopify-administrator er det sentrale knutepunktet for å administrere alle aspekter av bedriften din, og er utformet for å vise bare den mest nyttige og relevante informasjonen som standard. Den ekstra informasjonen som samles inn når handlinger utføres i administratoren din, lagres i .json-filene på ulike ressurssider. Disse ekstra detaljene vises ikke som standard, fordi den mengden informasjon ville vært overveldende og lite nyttig, og ville gjort administratoren vanskelig å bruke.

For de fleste forretningsoppgaver kan du bruke Shopifys eksisterende verktøy for å få tilgang til og tolke butikkens informasjon. Det kan imidlertid av og til være nyttig å se gjennom den spesifikke informasjonen om bestemte ressurser, som produkter eller bestillinger, når du feilsøker hvorfor eller når noe skjedde.

Eksempel: Få tilgang til en bestillings JSON-fil

I dette eksempelet skal du få tilgang til JSON-filen for en bestilling i Shopify-administrator.

Trinn:

Gå til Bestillinger fra Shopify-administratoren.
Klikk på en bestilling i Bestillinger-listen.
Legg til .json på slutten av URL-adressen i nettleserens adressefelt. Den vil ligne på dette eksempelet:

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

Trykk på Enter for å laste siden på nytt i JSON-format.
Valgfritt: Hvis du ikke har installert en utvidelse for JSON-visning i nettleseren, kan du aktivere innstillingen Pretty-print i nettleseren for å gjøre JSON-filen mer brukervennlig. Finn ut mer om å formatere en JSON-fil på nytt.

Du vil legge merke til at mye forventet informasjon om bestillingen vises, som «currency» og «line_items» knyttet til bestillingen, men at det også er inkludert mye annen detaljert informasjon, som «client_details» fra kundens nettleserøkt da de la inn bestillingen. Slik informasjon er nyttig for generell øktsporing og analyse av markedsføringsplattformer, men er ikke nødvendig for at du skal kunne behandle og innfri bestillingen.

Vise bestemte felter i en JSON-fil

Du kan tvinge JSON-filer til å vise bare bestemte felter, noe som kan gjøre informasjonen enklere å tolke når du vet hvilke bestemte egenskaper du vil inkludere. På slutten av en hvilken som helst JSON-fils URL-adresse i nettleserens adressefelt, kan du legge til ?fields= og deretter inkludere egenskapsnavnene du vil vise, i hvilken som helst rekkefølge, atskilt med komma.

For å for eksempel vise en bestillings ID, kundeinformasjon, totalpris og tagger, legger du til ?fields=id,customer,total_price,tags på slutten av JSON-filens URL-adresse, som i følgende eksempel:

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

Bruke andre JSON-ressurser

Du kan bruke følgende JSON-ressurser til å vise bestemt informasjon i Shopify-administrator:

Antall produkter: Legg til /count.json på slutten av URL-adressen til produktlisten for å vise det totale antallet produkter. Hele URL-adressen skal være:

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

Transaksjoner: Legg til /transactions.json på slutten av URL-adressen til en bestillingsside for å bare vise informasjon om bestillingstransaksjoner. Finn ut mer om Transaksjonsressursen.
Distribusjoner: Legg til /fulfillments.json på slutten av URL-adressen til en bestillingsside for å bare vise informasjon om bestillingsdistribusjon. Finn ut mer om Distribusjonsressursen.
Forlatte kasser: Legg til .json på slutten av URL-adressen til en forlatt kasse for å vise detaljert informasjon om den forlatte kassen. Finn ut mer om ressursen for forlatt kasse.

Vanlige JSON-egenskaper for feilsøking

Tabellen nedenfor lister opp JSON-egenskaper du kan referere til for hjelp med feilsøking av ulike ressurstyper. Hvis du for eksempel vil bekrefte når et bestemt produkt ble publisert, kan du se gjennom produktets JSON-fil for egenskapen published_at, som viser dato og klokkeslett i ISO 8601-format.

Denne tabellen inkluderer ikke alle mulige JSON-ressurser eller -egenskaper som er lagret i Shopify-administratoren, så se Shopify Developer Documentation for definisjoner av ressurser eller egenskaper som ikke er inkludert her.

Lister opp noen eksempelressurser i administratorpanelet og vanlige egenskaper knyttet til dem, inkludert definisjoner for hva de kan brukes til under feilsøking.
Ressurs	JSON-egenskap	Definisjon
Produkt	`"product": { "created_at"`	Klokkeslettet og datoen da produktet opprinnelig ble opprettet.
	`"product": { "published_at"`	Klokkeslettet og datoen da produktets status ble satt til Aktiv.
	`"product": { "updated_at"`	Siste klokkeslett og dato produktet ble oppdatert. Dette kan inkludere endringer i produktbeskrivelsen, tittelen eller SEO-informasjon, i tillegg til automatiske oppdateringer som endringer på varelageret når et produkt kjøpes.
Variant	`"product": { "variants": [ { "created_at"`	Klokkeslettet og datoen da varianten opprinnelig ble opprettet. Dette kan være et annet tidspunkt enn da selve produktet ble opprettet.
	`"product": { "variants": [ { "updated_at"`	Siste klokkeslett og dato da varianten ble oppdatert. Dette kan være et annet tidspunkt enn da selve produktet sist ble oppdatert.
	`"product": { "variants": [ { "inventory_quantity"`	Den gjeldende databaseverdien og hva som er tilgjengelig for kunder å kjøpe. Dette kan være en negativ verdi hvis varelageret for varianten ikke spores, eller hvis det er satt til å overselge.
	`"product": { "variants": [ { "old_inventory_quantity"`	Databaseverdien før variantens siste `updated_at`-dato.
Bestilling	`"order": { "line_items": [ { "requires_shipping"`	Vises som `true` eller `false`. Dette angir produktets eller variantens fraktinnstillinger på tidspunktet bestillingen ble lagt inn.
	`"order": { "line_items": [ { "taxable"`	Vises som `true` eller `false`. Dette angir hvordan produktet eller varianten var konfigurert til å belaste avgifter på tidspunktet da bestillingen ble lagt inn.
	`"order": { "line_items": [ { "variant_inventory_management"`	Vises som `shopify`, `amazon_marketplace_web`, `null` eller en tredjepartsverdi, avhengig av hvilken oppfyllelsestjeneste som er satt til å spore produktets varelager. En verdi på `null` betyr at produktet ikke ble sporet på bestillingstidspunktet.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Viser hvor mye av varelageret som fortsatt er reservert av systemet for å fullføre bestillingen. Dette er ikke det samme som det gjeldende varelageret for varianten.
	`"order": { "line_items": [ { "quantity"`	Antall produkter eller varianter som er kjøpt.
	`"order": { "line_items": [ { "tax_lines"`	I USA viser dette verdier for delstat, fylke og kommune. Hvis ingen avgiftslinjer vises, men det ble belastet avgift på bestillingen, betyr det at avgiften ble belastet på fraktomkostningene.
Kunde	`"customer": { "created_at"`	Klokkeslett og dato da kunden opprinnelig ble opprettet.
Kunde	`"customer": { "updated_at"`	Siste klokkeslett og dato da kundeprofilen ble oppdatert.

Metafelt i JSON

Metafelt er en fleksibel måte å knytte til ytterligere egendefinert informasjon til en Shopify-ressurs, som for eksempel produkter eller samlinger. Noen eksempler på data som lagres ved hjelp av metafelt, er produktspesifikasjoner, størrelsestabeller, nedlastbare dokumenter, utgivelsesdatoer, bilder eller delenumre. Finn ut mer om bruk av metafelt.

Du kan legge til /metafields.json på slutten av URL-adressen til en støttet ressursside for å vise metafeltene som er knyttet til den ressursen. Se tabellen nedenfor for noen eksempler på ressurser og URL-formater du kan bruke for å vise metafeltopplysninger ved hjelp av JSON.

Liste over noen eksempel-administratorressurser sammen med en eksempel-URL-adresse for en JSON-metafeltfil.
Eksempel på ressurstype	Eksempel-URL-adresse
Smartkolleksjon	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Kunde	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Bestilling	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Side	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Produkt	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Variant	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Produktbilde	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Merk: Metafelt for produktbilder kan bare legges til via API-et. Erstatt `{id}` og andre plassholdere i URL-adressen med de faktiske verdiene fra API-spørringene dine.
Butikk	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

For en komplett liste over ressurser som kan ha metafelt, og de spesifikke typene egenskaper som lagres for hver ressurstype, kan du se JSON-ressursen Metafelt i Shopify Developer Documentation.

Hendelser i JSON

Hendelser genereres av enkelte Shopify-ressurser når bestemte handlinger fullføres, for eksempel oppretting av et blogginnlegg, distribusjon av en bestilling eller at et produkt legges til.

Du kan legge til /events.json på slutten av URL-adressen til en støttet ressursside for å vise hendelsene som er knyttet til den ressursen. Se tabellen nedenfor for noen eksempler på ressurser og URL-formater du kan bruke til å vise hendelsesinformasjon ved hjelp av JSON.

Liste over noen eksempel-administratorressurser sammen med en eksempel-URL-adresse for en JSON-hendelsesfil.
Eksempel på ressurstype	Eksempel-URL-adresse
Bestilling	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Denne filen viser `author` for hendelser, som informerer deg om hvilke brukere som har fullført visse handlinger, som for eksempel hvem eller hva som publiserte et produkt.
Produkt	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Denne filen viser `author` for hendelser, som informerer deg om hvilke brukere som har fullført visse handlinger, for eksempel hvem eller hva som markerte en innbetaling som betalt.
Butikk	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Dette URL-formatet viser de 250 siste hendelsene som har funnet sted i butikken din. Hendelser kan inkludere, men er ikke begrenset til, produktopprettelse eller -oppdateringer, sideslettinger og variantoppdateringer.

For en komplett liste over ressurser som kan opprette hendelser, og de spesifikke hendelsene som opprettes for hver ressurstype, kan du se JSON-ressursen Hendelse i Shopify Developer Documentation.