Shopify Flow och GraphQL Admin API

Flow använder Shopify GraphQL Admin API för att bygga automatiseringar och integrationer som utökar och förbättrar Shopify admin. Flow använder version 2026-01 av API:et för att utvärdera villkor och variabler i arbetsflöden samt vidta åtgärder i din Shopify-butik. Eftersom Flow får åtkomst till butiksdata via API-anrop har du från Flow tillgång till nästan alla fält som är tillgängliga i API:et.

Eftersom Shopify släpper nya API-versioner var tredje månad kan vissa arbetsflöden behöva uppdateras när fält ändras eller blir föråldrade.

Använda GraphQL Admin API i arbetsflöden

De flesta åtgärderna i Flow använder GraphQL Admin API för att göra ändringar i din Shopify-butik. Till exempel använder åtgärden Lägg till ordertaggar mutationen tagsAdd. Åtgärden Skicka Admin API-förfrågan kan använda de flesta mutationer, inklusive de som ännu inte är tillgängliga som åtgärder i Flow.

När du skapar arbetsflöden kommer du ofta att stöta på fältnamn och beskrivningar som baseras på syntaxen för GraphQL Admin API. För att till exempel fastställa den totala säljbara kvantiteten för en variant i ett arbetsflöde använder du variabeln variants_item.inventoryQuantity. För att avgöra platsen där en kund prenumererade på ditt e-postnyhetsbrev använder du variabeln emailSubscriptionMethod.

Du behöver inte behärska API:et för att skapa arbetsflöden med Flow-appen, men att förstå lite om variabelnamn och deras definitioner kan hjälpa dig att bygga den specifika arbetsflödeslogik som du vill ha. Att till exempel känna till skillnaden mellan en kunds displayName och firstName kan hjälpa ditt arbetsflöde att komma åt rätt data beroende på vad du vill använda det till. Definitioner inkluderas med varje variabel när du bygger ditt arbetsflöde och du kan klicka på för att få mer information om en variabel eller definition.

Butiksdata och GraphQL Admin API

Arbetsflöden använder data från din butik i villkor och åtgärder. Flow kommer åt butiksdata med hjälp av GraphQL Admin API, vilket innebär att du har tillgång till nästan alla fält i API:et. Om en åtgärd inte har nödvändig data från utlösaren eller en Hämta data-åtgärd körs inte arbetsflödet och ett felmeddelande visas.

Ett arbetsflöde kan till exempel starta med utlösaren Kund skapad och importera kunddata till arbetsflödet. Om den utlösaren följs av en Lägg till ordertaggar-åtgärd, som kräver orderdata och inte kunddata, kommer arbetsflödet att resultera i ett felmeddelande om att data saknas.

Du kan behöva förhandsgranska data eller granska API-dokumentationen för att förstå vad som matas ut av API:et och används i Flow och för att säkerställa att ditt arbetsflöde matar ut den data som du förväntar dig.

Fältargument och GraphQL Admin API

Vissa fält i GraphQL Admin API kräver argument, ytterligare parametrar som begränsar vilken data som returneras. Fältet product.inCollection behöver till exempel ett id-argument för produktserien för att veta vilken produktserie som ska kontrolleras. Utan detta kan fältet inte returnera ett resultat.

I Flow kan du skapa variabler från dessa fält genom att ange det nödvändiga argumentvärdet, som sedan kan användas i arbetsflödet. Du kan också tilldela variabeln ett anpassat namn för att göra den lättare att referera till i efterföljande steg, till exempel genom att döpa product.inCollection(id: "gid://shopify/Collection/123456") till product.inSummerBestsellers.

Mer information om att skapa variabler från fält med argument.

Att skapa variabler från metafält kräver ytterligare information i Flow eftersom du själv definierar varje metafälts namnrymd och nyckel, vilket gör att argumenten alltid är unika för din butik. Mer information om metafält i Flow.

API-versionering

Shopify släpper nya API-versioner var tredje månad och Flow anammar nya versioner så snart som möjligt, men kan ligga efter den senaste versionen. När det är möjligt löses ändringar mellan versioner automatiskt, men vissa ändringar kanske inte är okomplicerade, inklusive i någon av följande situationer:

• När fält tas bort men ingen ersättning tillhandahålls, vilket potentiellt kan påverka hur villkor eller Liquid utvärderas.
• När fält blir nullbara, vilket potentiellt kan påverka hur villkor eller Liquid utvärderas.
• När enum-värden ändras eller nya union- eller gränssnittstyper läggs till, vilket potentiellt kan påverka Liquid eller kod.
• När mutationsargument ändras, vilket potentiellt kan påverka konfigurationen av åtgärderna för att Skicka Admin API-förfrågan.

Vissa arbetsflöden kan behöva uppdateras manuellt. I dessa fall kan arbetsflöden visa ett felmeddelande om Uppdatering krävs eller API som inte stöds och vägleda dig till relevant API-dokumentation för att göra de nödvändiga ändringarna i arbetsflödesredigeraren. När dessa uppdateringar har slutförts och sparats uppdateras arbetsflödet automatiskt för att använda den senaste API-versionen som är tillgänglig i Flow.

Du kan välja att tillfälligt ignorera problem för att göra brådskande ändringar i ett arbetsflöde med kompatibilitetsfel för API-versioner. Om dessa problem inte åtgärdas kan arbetsflödet sluta köras eller orsaka fel när den äldre API-versionen inte längre stöds av Shopify.