Adgang til detaljerede data i din Shopify-administrator med JSON

JSON, der er en forkortelse for JavaScript Object Notation, er et format til lagring og transport af data, der ofte bruges, når data sendes fra servere til websider. På de fleste ressourcesider i Shopify-administratoren, f.eks. siderne Ordrer, Produkter eller Kunder, kan du få adgang til mere detaljerede data ved hjælp af JSON.

Selvom det ikke er et krav, at du udfører avancerede udviklingsopgaver ved hjælp af JSON, kan det at have adgang til JSON-filen for en bestemt ressource i din Shopify-administrator hjælpe dig med selv at indsamle mere detaljerede oplysninger eller fejlfinde eller undersøge problemer. Du kan f.eks. gennemgå JSON-filen for et produkt for at finde dets variant-id, hvilket kan være påkrævet for visse datamigreringsopgaver eller tilpasninger af temakode. Som et andet eksempel kan du slå op i en ordres JSON-fil for at bekræfte den datavariabel, du vil bruge, når du opbygger et automatiseret workflow i Shopify Flow.

JSON bruges oftest af udviklere, men selv brugere med begrænset kodningskendskab kan have gavn af at lære, hvordan de finder og fortolker almindelige JSON-oplysninger i deres Shopify-administrator.

På denne side

Omformatering af en JSON-fil

Rå JSON-data vises som en lang række indlejrede variabler og kantede parenteser, hvilket er svært for en bruger at læse.

For at gøre JSON-formateringen mere læsevenlig kan du overveje en af følgende muligheder:

Installer en JSON-fremviserudvidelse i din browser.
Brug pretty-print-funktionaliteten, som de fleste moderne webbrowsere har som standard:

Skærmbillede af en JSON-produktfil med eksempel på produktoplysninger. Indstillingen for afkrydsningsfeltet “pretty-print” er aktiv og fremhævet øverst til venstre på siden.

Adgang til JSON-filer i din Shopify-administrator

Shopify-administratoren er det centrale omdrejningspunkt for administration af alle aspekter af din virksomhed og er designet til kun at vise de mest nyttige og relevante oplysninger som standard. De ekstra oplysninger, der indsamles, når der udføres handlinger i din administrator, gemmes i .json-filerne på forskellige ressourcesider. Disse ekstra detaljer vises ikke som standard, fordi mængden af oplysninger ville være overvældende og unødvendig og ville gøre din administrator svær at bruge.

Til de fleste virksomhedsopgaver kan du bruge Shopifys eksisterende værktøjer til at få adgang til og fortolke din butiks oplysninger. Det kan dog af og til være en hjælp at gennemgå de specifikke oplysninger om bestemte ressourcer, f.eks. produkter eller ordrer, når du fejlfinder, hvorfor eller hvornår noget skete.

Eksempel: Få adgang til en ordres JSON-fil

I dette eksempel får du adgang til JSON-filen for en ordre i din Shopify-administrator.

Fremgangsmåde:

Gå til Ordrer i din Shopify-administrator.
Klik på en vilkårlig ordre på listen Ordrer.
Tilføj .json i slutningen af webadressen i browserens adresselinje. Det vil se ud som i dette eksempel:

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

Tryk på Enter for at genindlæse siden i JSON-formatering.
Valgfrit: Hvis du ikke har installeret en JSON-fremviserudvidelse i din browser, skal du aktivere indstillingen Pretty-print i din browser for at gøre JSON-filen mere brugervenlig. Få mere at vide om omformatering af en JSON-fil.

Du vil bemærke, at der vises en masse forventede oplysninger om ordren, f.eks. "currency" og "line_items", der er knyttet til ordren, men der er også en masse andre detaljerede oplysninger, f.eks. "client_details" fra kundens browsersession, da vedkommende afgav ordren. Denne type oplysninger er nyttige til overordnet sessionssporing og analyse af marketingplatforme, men er ikke nødvendige for, at du kan behandle og klargøre ordren.

Visning af specifikke felter i en JSON-fil

Du kan tvinge JSON-filer til kun at vise specifikke felter, hvilket kan gøre oplysningerne lettere at fortolke, når du ved, hvilke bestemte egenskaber du vil inkludere. I slutningen af en webadresse til en JSON-fil i browserens adresselinje skal du tilføje ?fields= og derefter inkludere navnene på de egenskaber, du vil vise, i vilkårlig rækkefølge og adskilt af komma.

Hvis du f.eks. vil vise en ordres id, kundeoplysninger, samlet pris og tags, skal du tilføje ?fields=id,customer,total_price,tags til slutningen af JSON-filens webadresse, som i følgende eksempel:

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

Brug af andre JSON-ressourcer

Du kan bruge følgende JSON-ressourcer til at vise specifikke oplysninger i din Shopify-administrator:

Antal produkter: Tilføj /count.json til slutningen af webadressen for listen Produkter for at få vist det samlede antal produkter. Den fulde webadresse skal være:

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

Transaktioner: Tilføj /transactions.json til slutningen af webadressen for en ordreside for kun at vise oplysninger om ordretransaktioner. Få mere at vide om ressourcen Transactions.
Klargøringer: Tilføj /fulfillments.json til slutningen af webadressen for en ordreside for kun at vise oplysninger om ordreklargøring. Få mere at vide om ressourcen Fulfillment.
Forladte betalinger: Tilføj .json til slutningen af webadressen for en forladt betaling for at få vist detaljerede oplysninger om den forladte betaling. Få mere at vide om ressourcen Abandoned checkout.

Almindelige JSON-egenskaber til fejlfinding

Følgende tabel indeholder en liste over JSON-egenskaber, som du kan henvise til for at få hjælp til fejlfinding i forbindelse med forskellige ressourcetyper. Hvis du f.eks. vil bekræfte, hvornår et bestemt produkt blev udgivet, kan du gennemgå produktets JSON-fil for egenskaben published_at, som viser datoen og klokkeslættet i ISO 8601-format.

Denne tabel indeholder ikke alle mulige JSON-ressourcer eller -egenskaber, der er gemt i Shopify-administratoren, så se Shopifys udviklerdokumentation for definitioner af eventuelle ressourcer eller egenskaber, der ikke er medtaget her.

Liste over nogle eksempler på administratorressourcer og almindelige egenskaber, der er knyttet til dem, herunder definitioner af, hvad de kan bruges til i forbindelse med fejlfinding.
Ressource	JSON-egenskab	Definition
Produkt	`"product": { "created_at"`	Tidspunktet og datoen for, da produktet oprindeligt blev oprettet.
	`"product": { "published_at"`	Tidspunktet og datoen for, da produktets status blev angivet til Aktiv.
	`"product": { "updated_at"`	Seneste tidspunkt og dato for opdatering af produktet. Dette kan omfatte ændringer af produktbeskrivelsen, titlen eller SEO-oplysningerne samt automatiske opdateringer, f.eks. ændringer af lagerbeholdningen, når et produkt købes.
Variant	`"product": { "variants": [ { "created_at"`	Tidspunktet og datoen for, da varianten oprindeligt blev oprettet. Dette kan være forskelligt fra datoen og tidspunktet, da selve produktet blev oprettet.
	`"product": { "variants": [ { "updated_at"`	Seneste tidspunkt og dato for opdatering af varianten. Dette kan være forskelligt fra datoen og tidspunktet, da selve produktet sidst blev opdateret.
	`"product": { "variants": [ { "inventory_quantity"`	Den aktuelle databaseværdi og det, der er tilgængeligt for kunder at købe. Dette kan være en negativ værdi, hvis variantens lagerbeholdning ikke spores, eller hvis den er angivet til at tillade oversalg.
	`"product": { "variants": [ { "old_inventory_quantity"`	Databaseværdien før variantens seneste `updated_at`-dato.
Ordre	`"order": { "line_items": [ { "requires_shipping"`	Vises som `true` eller `false`. Dette angiver produktets eller variantens indstillinger for levering, da ordren blev afgivet.
	`"order": { "line_items": [ { "taxable"`	Vises som `true` eller `false`. Dette angiver, hvordan produktet eller varianten var angivet til at opkræve skatter, da ordren blev afgivet.
	`"order": { "line_items": [ { "variant_inventory_management"`	Vises som `shopify`, `amazon_marketplace_web`, `null` eller en tredjepartsværdi afhængigt af, hvilken klargøringstjeneste der er angivet til at spore produktets lagerbeholdning. En værdi på `null` betyder, at produktet ikke blev sporet på tidspunktet for ordren.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Viser, hvor meget lagerbeholdning der stadig er reserveret af systemet for at fuldføre ordren. Dette er ikke lig med den aktuelle lagerbeholdning for varianten.
	`"order": { "line_items": [ { "quantity"`	Antallet af købte produkter eller varianter.
	`"order": { "line_items": [ { "tax_lines"`	I USA viser dette værdier for delstat, amt og kommune. Hvis der ikke vises nogen skattelinjer, men der blev opkrævet skat på ordren, betyder det, at skatten blev opkrævet på leveringsomkostningerne.
Kunde	`"customer": { "created_at"`	Tidspunktet og datoen for, da kunden oprindeligt blev oprettet.
Kunde	`"customer": { "updated_at"`	Seneste tidspunkt og dato for opdatering af kundeprofilen.

Metafelter i JSON

Metafelter er en fleksibel måde at vedhæfte yderligere tilpassede oplysninger til en Shopify-ressource, f.eks. produkter eller kollektioner. Nogle eksempler på data, der gemmes ved hjælp af metafelter, er produktspecifikationer, størrelsesoversigter, dokumenter, der kan downloades, udgivelsesdatoer, billeder eller varenumre. Få mere at vide om brug af metafelter.

Du kan føje /metafields.json til slutningen af webadressen for en understøttet ressourceside for at få vist de metafelter, der er knyttet til den pågældende ressource. Se følgende tabel for nogle eksempler på ressourcer og webadresseformater, der kan bruges til at vise oplysninger om metafelter ved hjælp af JSON.

Liste over administratorressourcer med eksempler på webadresser til JSON-filer med metafelter.
Eksempel på ressourcetype	Eksempel på webadresse
Smart kollektion	`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`
Ordre	`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`
Produktbillede	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Bemærk: Metafelter for produktbilleder kan kun tilføjes via API'en. Erstat `{id}` og andre pladsholdere i webadressen med de faktiske værdier fra dine API-forespørgsler.
Butik	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Du kan se en komplet liste over ressourcer, der kan have metafelter, og de specifikke typer egenskaber, der gemmes for hver ressourcetype, i JSON-ressourcen Metafield i Shopifys udviklerdokumentation.

Hændelser i JSON

Hændelser genereres af nogle Shopify-ressourcer, når bestemte handlinger er fuldført, f.eks. oprettelse af et blogopslag, klargøring af en ordre eller tilføjelse af et produkt.

Du kan føje /events.json til slutningen af webadressen for en understøttet ressourceside for at få vist de hændelser, der er knyttet til den pågældende ressource. Se følgende tabel for nogle eksempler på ressourcer og webadresseformater, der kan bruges til at vise oplysninger om hændelser ved hjælp af JSON.

Liste over administratorressourcer med eksempler på webadresser til JSON-filer med hændelser.
Eksempel på ressourcetype	Eksempel på webadresse
Ordre	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Denne fil angiver `forfatteren` af hændelserne, så du kan se, hvilke brugere der har udført bestemte handlinger, f.eks. hvem eller hvad der har udgivet et produkt.
Produkt	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Denne fil angiver `forfatteren` af hændelserne, så du kan se, hvilke brugere der har udført bestemte handlinger, f.eks. hvem eller hvad der har markeret en betaling som betalt.
Butik	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Dette webadresseformat viser de 250 seneste hændelser, der har fundet sted i din butik. Hændelser kan omfatte, men er ikke begrænset til, oprettelse eller opdateringer af produkter, sletninger af sider og opdateringer af varianter.

Du kan se en komplet liste over ressourcer, der kan oprette begivenheder, og de specifikke begivenheder, der oprettes for hver ressourcetype, i JSON-ressourcen Event i Shopifys udviklerdokumentation.