Få åtkomst till detaljerade data i din Shopify-admin med JSON

JSON, en förkortning för JavaScript Object Notation, är ett format för att lagra och transportera data som ofta används när data skickas från servrar till webbsidor. På de flesta resurssidor i Shopify-admin, till exempel sidorna Ordrar, Produkter eller Kunder, kan du komma åt mer detaljerad data med hjälp av JSON.

Även om du inte behöver utföra avancerade utvecklingsuppgifter med JSON kan det vara till hjälp att komma åt JSON-filen för en viss resurs i din Shopify-admin. Det kan hjälpa dig att samla in mer detaljerad information eller att felsöka problem på egen hand. Du kan till exempel granska JSON-filen för en produkt för att hitta dess variant-ID, vilket kan krävas för vissa datamigreringsuppgifter eller anpassningar av temakod. Du kan även hänvisa till en orders JSON-fil för att bekräfta den datavariabel som du vill använda när du bygger ett automatiserat arbetsflöde i Shopify Flow.

JSON används oftast av utvecklare, men även användare med begränsad kunskap om kodning kan ha nytta av att lära sig att hitta och tolka viss vanlig JSON-information i sin Shopify-admin.

På den här sidan

Formatera om en JSON-fil

Råa JSON-data visas som en lång sekvens av nästlade variabler och hakparenteser, vilket är svårt för en mänsklig användare att läsa.

Överväg något av följande alternativ för att göra JSON-formateringen mer läsbar:

Installera ett JSON-visartillägg i din webbläsare.
Använd funktionen ”pretty-print” som de flesta moderna webbläsare har som standard:

Skärmbild av en JSON-produktfil med produktinformation som exempel. Inställningen för kryssrutan ”pretty-print” är aktiv och markerad längst upp till vänster på sidan.

Få åtkomst till JSON-filer i din Shopify-admin

Shopify-admin är det centrala navet för att hantera alla aspekter av din verksamhet och är utformad för att som standard endast visa den mest användbara och relevanta informationen. Den extra information som samlas in när åtgärder utförs i din adminpanel lagras i .json-filerna på olika resurssidor. Dessa extra uppgifter visas inte för dig som standard eftersom den mängden information skulle vara överväldigande och inte till hjälp, och skulle göra din adminpanel svår att använda.

För de flesta affärsuppgifter kan du använda Shopifys befintliga verktyg för att komma åt och tolka din butiks information. Det kan dock ibland vara till hjälp att granska den specifika informationen om vissa resurser, till exempel produkter eller ordrar, vid felsökning av varför eller när något hände.

Exempel: Få åtkomst till en orders JSON-fil

I det här exemplet kommer du åt JSON-filen för en order i din Shopify-admin.

Steg:

Gå till Ordrar från din Shopify-admin.
Klicka på valfri order i listan Ordrar.
I webbläsarens adressfält lägger du till .json i slutet av URL-adressen. Den kommer att likna det här exemplet:

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

Tryck på Retur för att läsa in sidan på nytt i JSON-format.
Valfritt: Om du inte har ett JSON-visartillägg installerat i din webbläsare kan du aktivera inställningen Pretty-print i din webbläsare för att göra JSON-filen mer användarvänlig. Läs mer om att omformatera en JSON-fil.

Du kommer att märka att mycket förväntad information om ordern visas, till exempel "currency" och "line_items" som är kopplade till ordern, men även en hel del annan detaljerad information, såsom "client_details" från kundens webbläsarsession när hen lade ordern. Den här typen av information är användbar för övergripande sessionsspårning och analys av marknadsföringsplattformar, men är inte nödvändig för att du ska kunna behandla och distribuera ordern.

Visa specifika fält i en JSON-fil

Du kan tvinga JSON-filer att endast visa specifika fält, vilket kan göra informationen lättare att tolka när du vet vilka egenskaper du vill inkludera. I slutet av en JSON-fils URL i webbläsarens adressfält lägger du till ?fields= och inkluderar sedan de egenskapsnamn du vill visa, i valfri ordning, separerade med ett kommatecken.

Om du till exempel vill visa en orders ID, kundinformation, totalpris och taggar, lägg till ?fields=id,customer,total_price,tags i slutet av JSON-filens URL, som i följande exempel:

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

Använda andra JSON-resurser

Du kan använda följande JSON-resurser för att visa specifik information i din Shopify-admin:

Antal produkter: Lägg till /count.json i slutet av URL:en för produktlistan för att visa det totala antalet produkter. Den fullständiga URL:en ska vara:

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

Transaktioner: Lägg till /transactions.json i slutet av en ordersidas URL för att endast visa orderns transaktionsinformation. Läs mer om Transaktionsresursen.
Distributioner: Lägg till /fulfillments.json i slutet av en ordersidas URL för att endast visa orderns distributionsinformation. Läs mer om Distributionsresursen.
Övergivna kassor: Lägg till .json i slutet av URL:en för en övergiven kassa för att visa detaljerad information om den övergivna kassan. Läs mer om resursen för övergivna kassor.

Vanliga JSON-egenskaper för felsökning

Följande tabell listar JSON-egenskaper som du kan hänvisa till för felsökningshjälp med olika resurstyper. Om du till exempel vill bekräfta när en viss produkt publicerades kan du granska produktens JSON-fil för egenskapen published_at, som visar datum och tid i ISO 8601-format.

Den här tabellen innehåller inte alla möjliga JSON-resurser eller -egenskaper som lagras i Shopify-admin, så se Shopifys utvecklardokumentation för definitioner av resurser eller egenskaper som inte ingår här.

Listar några exempel på adminresurser och vanliga egenskaper som är kopplade till dem, inklusive definitioner för vad de kan användas till vid felsökning.
Resurs	JSON-egenskap	Definition
Produkt	`"product": { "created_at"`	Tid och datum då produkten ursprungligen skapades.
	`"product": { "published_at"`	Tid och datum då produktens status ändrades till Aktiv.
	`"product": { "updated_at"`	Den senaste tidpunkten och datumet då produkten uppdaterades. Detta kan innefatta ändringar i produktbeskrivningen, titeln eller SEO-informationen samt automatiska uppdateringar såsom lagerändringar när en produkt köps.
Variant	`"product": { "variants": [ { "created_at"`	Tid och datum då varianten ursprungligen skapades. Detta kan skilja sig från datumet och tiden då den övergripande produkten skapades.
	`"product": { "variants": [ { "updated_at"`	Den senaste tidpunkten och datumet då varianten uppdaterades. Detta kan skilja sig från datumet och tiden då den övergripande produkten senast uppdaterades.
	`"product": { "variants": [ { "inventory_quantity"`	Det aktuella databasvärdet och vad som är tillgängligt för kunder att köpa. Detta kan vara ett negativt värde om variantens lager inte spåras, eller om det är inställt på översäljning.
	`"product": { "variants": [ { "old_inventory_quantity"`	Databasvärdet före variantens senaste `updated_at`-datum.
Order	`"order": { "line_items": [ { "requires_shipping"`	Visas som `true` eller `false`. Detta indikerar produktens eller variantens leveransinställningar vid tidpunkten då ordern lades.
	`"order": { "line_items": [ { "taxable"`	Visas som `true` eller `false`. Detta indikerar hur produkten eller varianten var inställd för att debitera skatt vid den tidpunkt då ordern lades.
	`"order": { "line_items": [ { "variant_inventory_management"`	Visas som `shopify`, `amazon_marketplace_web`, `null` eller ett tredjepartsvärde beroende på vilken distributionstjänst som är inställd för att spåra produktens lager. Ett värde på `null` innebär att produkten inte spårades vid ordertillfället.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Visar hur mycket lager som fortfarande är reserverat av systemet för att kunna slutföra ordern. Detta är inte detsamma som det aktuella variantlagret.
	`"order": { "line_items": [ { "quantity"`	Antalet köpta produkter eller varianter.
	`"order": { "line_items": [ { "tax_lines"`	I USA visas värden för delstat, county och kommun. Om inga skatterader visas, men skatt har debiterats för ordern, innebär detta att skatten har debiterats på leveranskostnaden.
Kund	`"customer": { "created_at"`	Tid och datum då kunden ursprungligen skapades.
Kund	`"customer": { "updated_at"`	Den senaste tidpunkten och datumet då kundprofilen uppdaterades.

Metafält i JSON

Metafält är ett flexibelt sätt att bifoga ytterligare anpassad information till en Shopify-resurs, till exempel produkter eller produktserier. Några exempel på data som lagras med hjälp av metafält är produktspecifikationer, storleksguider, nedladdningsbara dokument, utgivningsdatum, bilder eller artikelnummer. Läs mer om att använda metafält.

Du kan lägga till /metafields.json i slutet av en URL för en resurssida som stöds för att visa de metafält som är kopplade till den resursen. Se tabellen nedan för några exempel på resurser och URL-format som du kan använda för att visa metafältinformation med JSON.

Lista över några exempel på adminresurser tillsammans med ett exempel på en URL till en JSON-metafältfil.
Exempel på resurstyp	Exempel på URL
Smart produktserie	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Kund	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Order	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Sida	`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`
Produktbild	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Obs! Metafält för produktbilder kan endast läggas till via API. Ersätt `{id}` och andra platshållare i URL:en med de faktiska värdena från dina API-förfrågningar.
Butik	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

För en fullständig lista över resurser som kan ha metafält och de specifika typerna av egenskaper som lagras för varje resurstyp, se JSON-resursen Metafält i Shopifys utvecklardokumentation.

Händelser i JSON

Händelser genereras av vissa Shopify-resurser när vissa åtgärder slutförs, till exempel när ett blogginlägg skapas, en order distribueras eller en produkt läggs till.

Du kan lägga till /events.json i slutet av en URL för en resurssida som stöds för att visa de händelser som är kopplade till den resursen. Se tabellen nedan för några exempel på resurser och URL-format som du kan använda för att visa händelseinformation med JSON.

Lista över några exempel på adminresurser tillsammans med ett exempel på en URL till en JSON-händelsefil.
Exempel på resurstyp	Exempel på URL
Order	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Den här filen listar `author` för händelser, vilket informerar dig om vilka användare som har slutfört vissa åtgärder, till exempel vem eller vad som publicerade en produkt.
Produkt	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Den här filen listar `author` för händelser, vilket informerar dig om vilka användare som har utfört vissa åtgärder, till exempel vem eller vad som har markerat en betalning som betald.
Butik	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Det här URL-formatet visar de 250 senaste händelserna i din butik. Händelser kan inkludera, men är inte begränsade till, skapande eller uppdateringar av produkter, sidborttagningar och variantuppdateringar.

För en fullständig lista över resurser som kan skapa händelser och de specifika händelser som skapas för varje resurstyp, se JSON-resursen Händelse i Shopifys utvecklardokumentation.