Shopify Flow og GraphQL Admin API

Flow bruger Shopify GraphQL Admin API til at bygge automatiseringer og integrationer, der udvider og forbedrer Shopify-administratoren. Flow bruger version 2026-01 af API'en til at evaluere betingelser og variabler i workflows samt til at udføre handlinger i din Shopify-butik. Da Flow tilgår butiksdata ved at kalde API'en, har du via Flow adgang til næsten alle de felter, der er tilgængelige i API'en.

Da Shopify udgiver nye API-versioner hver 3. måned, kan det være nødvendigt at opdatere nogle workflows, når felter ændres eller udfases.

Brug af GraphQL Admin API i workflows

De fleste handlinger i Flow bruger GraphQL Admin API til at foretage ændringer i din Shopify-butik. For eksempel bruger handlingen Tilføj ordretags mutationen tagsAdd. Handlingen Send Admin API-anmodning kan bruge de fleste mutationer, herunder dem, der endnu ikke er tilgængelige som handlinger i Flow.

Når du opretter workflows, vil du ofte støde på feltnavne og beskrivelser, der er baseret på syntaksen for GraphQL Admin API. Hvis du f.eks. vil bestemme det samlede salgbare antal af en variant i et workflow, skal du bruge variablen variants_item.inventoryQuantity. For at bestemme den lokation, hvor en kunde har tilmeldt sig dit nyhedsbrev, bruger du tilsvarende variablen emailSubscriptionMethod.

Du behøver ikke at have et indgående kendskab til API'en for at oprette workflows med Flow-appen, men en smule forståelse for variabelnavne og deres definitioner kan hjælpe dig med at bygge den specifikke workflowlogik, du ønsker. Hvis du f.eks. kender forskellen på en kundes displayName og firstName, kan det hjælpe dit workflow med at få adgang til de korrekte data afhængigt af, hvad du vil bruge dem til. Der følger definitioner med hver variabel, efterhånden som du bygger dit workflow, og du kan klikke på for at få mere at vide om en variabel eller definition.

Butiksdata og GraphQL Admin API

Workflows bruger data fra din butik i betingelser og handlinger. Flow tilgår butiksdata ved hjælp af GraphQL Admin API, hvilket betyder, at du har adgang til næsten alle felterne i API'en. Hvis en handling ikke har de nødvendige data, der leveres af udløseren eller en Hent data-handling, kører workflowet ikke, og der vises en fejlmeddelelse.

Et workflow starter f.eks. med en Kunde oprettet-udløser og importerer kundedata til workflowet. Hvis den udløser efterfølges af en Tilføj ordretags-handling, som kræver ordredata og ikke kundedata, vil workflowet resultere i en fejl om manglende data.

Du kan få brug for at forhåndsvise data eller gennemgå API-dokumentationen for at forstå, hvad der outputtes af API'en og bruges i Flow, og for at sikre, at dit workflow outputter de data, du forventer.

Feltargumenter og GraphQL Admin API

Nogle GraphQL Admin API-felter kræver argumenter. Det er yderligere parametre, som indsnævrer de data, der returneres. For eksempel kræver feltet product.inCollection et argument for kollektionens id for at vide, hvilken kollektion der skal kontrolleres. Uden dette argument kan feltet ikke returnere et resultat.

I Flow kan du oprette variabler fra disse felter ved at angive den påkrævede argumentværdi, som derefter kan bruges i dit workflow. Du kan også tildele variablen et tilpasset navn for at gøre det nemmere at henvise til den i efterfølgende trin. Du kan for eksempel navngive product.inCollection(id: "gid://shopify/Collection/123456") som product.inSummerBestsellers.

Få mere at vide om oprettelse af variabler fra felter med argumenter.

Oprettelse af variabler fra metafelter kræver yderligere oplysninger i Flow, fordi du selv definerer navneområdet og nøglen for hvert metafelt. Derfor vil argumenterne altid være unikke for din butik. Få mere at vide om metafelter i Flow.

API-versionering

Shopify udgiver nye API-versioner hver 3. måned, og Flow indfører nye versioner så hurtigt som muligt, men kan være bagud i forhold til den seneste version. Når det er muligt, løses ændringer mellem versioner automatisk, men nogle ændringer er muligvis ikke ligetil, herunder i følgende situationer:

• Når felter fjernes, men der ikke angives nogen erstatning, hvilket potentielt kan påvirke, hvordan betingelser eller Liquid evalueres.
• Når felter kan have en null-værdi, hvilket potentielt kan påvirke, hvordan betingelser eller Liquid evalueres.
• Når enum-værdier ændres, eller der tilføjes nye union- eller grænsefladetyper, hvilket potentielt kan påvirke Liquid eller kode.
• Når mutationsargumenter ændres, hvilket potentielt kan påvirke konfigurationen af handlinger af typen Send Admin API-anmodning.

Nogle workflows skal muligvis opdateres manuelt. I disse tilfælde kan workflows vise en Opdatering påkrævet- eller Ikke-understøttet API-fejl og guide dig til den relevante API-dokumentation for at foretage de nødvendige ændringer i workfloweditoren. Når disse opdateringer er fuldført og gemt, opdateres workflowet automatisk til at bruge den seneste API-version, der er tilgængelig i Flow.

Du kan vælge at ignorere problemer midlertidigt for at foretage presserende ændringer i et workflow med fejl i API-versionskompatibilitet. Hvis disse problemer ikke løses, vil workflowet muligvis stoppe med at køre eller forårsage fejl, når den ældre API-version ikke længere understøttes af Shopify.