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 för närvarande API-version 2024-07 för att utvärdera villkor och variabler i arbetsflöden samt vidta åtgärder i din Shopify-butik. Eftersom Flow kommer åt data från butiken genom att anropa API:et har du tillgång till nästan alla fält som är tillgängliga i API:et från Flow.

De flesta åtgärder i Flow använder API:et 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-begäran kan använda de flesta mutationer, inklusive dem 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 baserade på API:et. 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 samt för att säkerställa att ditt arbetsflöde matar ut de data du förväntar dig.

API-versioner

Shopify släpper nya API-versioner var tredje månad och Flow tar nya versioner i bruk så snart som möjligt, men kanske inte har den senaste versionen. Om möjligt löses ändringar mellan versioner automatiskt, men vissa ändringar kan vara komplicerade, inklusive följande: * När fält tas bort men ingen ersättning tillhandahålls, vilket kan påverka hur villkor eller Liquid utvärderas. * När fält anges som null, vilket kan påverka hur villkor eller Liquid utvärderas. * När enum-värden ändras eller nya unions- eller gränssnittstyper läggs till, vilket kan påverka Liquid eller kod. * När mutationsargument ändras, kan det potentiellt påverka konfigurationen av åtgärden Skicka Admin API-förfrågan.

Vissa arbetsflöden kan behöva uppdateras manuellt. I dessa fall kan arbetsflöden visa felet Uppdatering krävs eller API stöds inte och hänvisa 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 finns tillgänglig i Flow.

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