Shopify Flow og GraphQL Admin API

Flow bruker Shopify GraphQL Admin API til å bygge automasjoner og integrasjoner som utvider og forbedrer Shopify-administratorpanelet. Flow bruker versjon 2026-01 av API-et til å evaluere betingelser og variabler i arbeidsflyter, samt utføre handlinger i Shopify-butikken din. Siden Flow får tilgang til butikkdata ved å kalle på API-et, har du tilgang til nesten alle feltene som er tilgjengelige i API-et fra Flow.

Siden Shopify lanserer nye API-versjoner hver tredje måned, kan det hende at noen arbeidsflyter må oppdateres når felt endres eller avvikles.

Bruk av GraphQL Admin API i arbeidsflyter

De fleste handlingene i Flow bruker GraphQL Admin API til å gjøre endringer i Shopify-butikken din. For eksempel bruker handlingen Legg til bestillingsetiketter tagsAdd-mutasjonen. Handlingen Send Admin API-forespørsel kan bruke de fleste mutasjoner, inkludert de som ennå ikke er tilgjengelige som handlinger i Flow.

Når du oppretter arbeidsflyter, vil du ofte støte på feltnavn og beskrivelser basert på syntaksen i GraphQL Admin API. For å finne det totale salgsklare antallet for en variant i en arbeidsflyt, bruker du for eksempel variabelen variants_item.inventoryQuantity. For å finne stedet der en kunde abonnerte på e-postnyhetsbrevet ditt, bruker du variabelen emailSubscriptionMethod.

Du trenger ikke å være ekspert på API-et for å opprette arbeidsflyter med Flow-appen, men å forstå litt om variabelnavn og definisjonene deres kan hjelpe deg med å bygge den spesifikke arbeidsflytlogikken du ønsker. For eksempel kan det å kjenne til forskjellen på en kundes displayName og firstName hjelpe arbeidsflyten din med å få tilgang til de riktige dataene, avhengig av hva du vil bruke dem til. Definisjoner er inkludert for hver variabel når du bygger arbeidsflyten, og du kan klikke på for å finne ut mer om en variabel eller definisjon.

Butikkdata og GraphQL Admin API

Arbeidsflyter bruker data fra butikken din i betingelser og handlinger. Flow får tilgang til butikkdata ved hjelp av GraphQL Admin API, som betyr at du har tilgang til nesten alle feltene i API-et. Hvis en handling ikke har de nødvendige dataene fra utløseren eller en Hent data-handling, kjøres ikke arbeidsflyten, og det vises en feilmelding.

For eksempel starter en arbeidsflyt med en Kunde opprettet-utløser og importerer kundedata til arbeidsflyten. Hvis denne utløseren følges av handlingen Legg til bestillingsetiketter, som krever bestillingsdata og ikke kundedata, vil arbeidsflyten resultere i en feil om manglende data.

Det kan hende du må forhåndsvise data eller se gjennom API-dokumentasjonen for å forstå hva som mates ut av API-et og brukes i Flow, og for å sikre at arbeidsflyten din mater ut de dataene du forventer.

Feltargumenter og GraphQL Admin API

Noen felt i GraphQL Admin API krever argumenter, som er ekstra parametere for å begrense hvilke data som returneres. For eksempel trenger feltet product.inCollection et id-argument for samlingen for å vite hvilken samling som skal sjekkes. Uten dette kan ikke feltet returnere et resultat.

I Flow kan du opprette variabler fra disse feltene ved å oppgi den påkrevde argumentverdien, som deretter kan brukes i arbeidsflyten. Du kan også tilordne et egendefinert navn til variabelen for å gjøre det enklere å referere til den i senere trinn. Du kan for eksempel gi product.inCollection(id: "gid://shopify/Collection/123456") navnet product.inSummerBestsellers.

Finn ut mer om hvordan du oppretter variabler fra felt med argumenter.

Å opprette variabler fra metafelt krever ytterligere informasjon i Flow fordi du definerer hvert metafelts navnefelt og nøkkel selv, slik at argumentene alltid er unike for butikken. Finn ut mer om metafelt i Flow.

API-versjonering

Shopify lanserer nye API-versjoner hver tredje måned, og Flow tar i bruk nye versjoner så snart som mulig, men kan ligge bak den nyeste versjonen. Når det er mulig, løses endringer mellom versjoner automatisk, men noen endringer er kanskje ikke like enkle, inkludert i noen av følgende situasjoner:

• Når felt fjernes uten at det gis en erstatning, kan det påvirke hvordan betingelser eller Liquid evalueres.
• Når felt blir null-bare, kan det påvirke hvordan betingelser eller Liquid evalueres.
• Når enum-verdier endres eller nye union- eller grensesnitt-typer legges til, kan det påvirke Liquid eller kode.
• Når mutasjonsargumenter endres, kan det påvirke konfigurasjonen av Send Admin API-forespørsel-handlinger.

Noen arbeidsflyter må kanskje oppdateres manuelt. I slike tilfeller kan arbeidsflyter vise feilmeldingen Oppdatering kreves eller API ikke støttet og veilede deg til den relevante API-dokumentasjonen for å gjøre de nødvendige endringene i arbeidsflytredigereren. Når disse oppdateringene er fullført og lagret, oppdateres arbeidsflyten automatisk til å bruke den nyeste API-versjonen som er tilgjengelig i Flow.

Du kan velge å ignorere problemer midlertidig for å gjøre hasteendringer i en arbeidsflyt med kompatibilitetsfeil for API-versjoner. Hvis disse problemene ikke løses, kan arbeidsflyten slutte å kjøre eller forårsake feil når den eldre API-versjonen ikke lenger støttes av Shopify.