Shopify Flow ja GraphQL Admin API

Flow kasutab Shopify GraphQL Admin API-t automatiseerimiste ja integratsioonide loomiseks, mis laiendavad ja täiustavad Shopify administraatorit. Flow kasutab API versiooni 2026-01, et hinnata töövoogudes tingimusi ja muutujaid ning teha oma Shopify poes toiminguid. Kuna Flow pääseb poe andmetele juurde API-t kutsudes, on sul Flow kaudu juurdepääs peaaegu kõigile API-s saadaolevatele väljadele.

Kuna Shopify annab iga kolme kuu tagant välja uusi API versioone, võib väljade muutmise või kasutuselt kõrvaldamise korral olla vaja mõnda töövoogu uuendada.

GraphQL Admin API kasutamine töövoogudes

Enamik rakenduse Flow tegevusi kasutab sinu Shopify poes muudatuste tegemiseks liidest GraphQL Admin API. Näiteks tegevus Lisa tellimuse sildid kasutab mutatsiooni tagsAdd. Tegevus Saada Admin API taotlus saab kasutada enamikku mutatsioone, sealhulgas neid, mis ei ole veel rakenduses Flow tegevustena saadaval.

Töövoogude loomisel puutud sageli kokku väljade nimede ja kirjeldustega, mis põhinevad GraphQL Admin API süntaksil. Näiteks variandi kogu müügikõlbliku koguse määramiseks töövoos kasutad muutujat variants_item.inventoryQuantity. Teine näide: asukoha määramiseks, kus klient sinu e-posti uudiskirjaga liitus, kasutad muutujat emailSubscriptionMethod.

Rakendusega Flow töövoogude loomiseks ei pea sa olema API ekspert, kuid teadmised muutujate nimedest ja nende määratlustest aitavad luua just sellise töövoo loogika, nagu soovid. Näiteks teadmine, mis vahe on kliendi muutujatel displayName ja firstName, aitab sinu töövoos õigetele andmetele juurde pääseda, sõltuvalt sellest, milleks soovid neid kasutada. Iga muutujaga on töövoo loomisel kaasas määratlused ja võid klõpsata ikooni , et saada lisateavet mis tahes muutuja või määratluse kohta.

Poe andmed ja GraphQL Admin API

Töövood kasutavad tingimustes ja tegevustes sinu poe andmeid. Rakendus Flow pääseb poe andmetele juurde liidese GraphQL Admin API kaudu, mis tähendab, et sul on juurdepääs peaaegu kõigile API väljadele. Kui tegevusel puuduvad vajalikud andmed, mida pakub käivitaja või tegevus Hangi andmeid, siis töövoog ei käivitu ja kuvatakse veateade.

Näiteks töövoog algab käivitajaga Klient on loodud ja impordib kliendi andmed töövoogu. Kui sellele käivitajale järgneb tegevus Lisa tellimuse sildid, mis nõuab tellimuse, mitte kliendi andmeid, annab töövoog puuduvate andmete vea.

Võimalik, et pead andmeid eelvaatama või üle vaatama API dokumentatsiooni, et mõista, mida API väljastab ja mida Flow's kasutatakse, ning tagamaks, et sinu töövoog väljastab andmeid, mida ootad.

Välja argumendid ja GraphQL Admin API

Mõned GraphQL Admin API väljad nõuavad argumente, mis on täiendavad parameetrid tagastatavate andmete kitsendamiseks. Näiteks väli product.inCollection vajab kollektsiooni argumenti id, et teada, millist kollektsiooni kontrollida. Ilma selleta ei saa väli tulemust tagastada.

Rakenduses Flow saad neist väljadest luua muutujaid, esitades nõutud argumendi väärtuse, mida saab seejärel töövoos kasutada. Samuti saad määrata muutujale kohandatud nime, et sellele oleks hilisemates sammudes lihtsam viidata, nimetades näiteks muutuja product.inCollection(id: "gid://shopify/Collection/123456") nimega product.inSummerBestsellers.

Lisateave argumentidega väljadest muutujate loomise kohta.

Metaväljadest muutujate loomine nõuab rakenduses Flow lisateavet, kuna määrad iga metavälja nimeruumi ja võtme ise, seega on argumendid alati sinu poe jaoks unikaalsed. Lisateave metaväljade kohta Flow's.

API versioonimine

Shopify laseb iga kolme kuu tagant välja uued API versioonid ja Flow võtab uued versioonid kasutusele niipea kui võimalik, kuid võib jääda uusimast versioonist maha. Võimaluse korral lahendatakse versioonide vahelised muudatused automaatselt, kuid mõned muudatused ei pruugi olla sirgjoonelised, sealhulgas järgmised olukorrad:

• Kui väljad eemaldatakse, kuid asendust ei pakuta, mis võib mõjutada tingimuste või Liquidi hindamist.
• Kui väljad muutuvad nullitavaks, mis võib mõjutada tingimuste või Liquidi hindamist.
• Kui loendiväärtused muutuvad või lisatakse uusi ühendi- või liidesetüüpe, mis võib mõjutada Liquidi või koodi.
• Kui mutatsiooni argumendid muutuvad, mis võib mõjutada tegevuse Saada Admin API taotlus seadistust.

Mõningaid töövooge võib olla vaja käsitsi uuendada. Sellistel juhtudel võivad töövood kuvada vea Uuendamine nõutav või Toetamata API ja suunata sind asjakohasele API dokumentatsioonile, et teha töövoo redaktoris vajalikud muudatused. Kui need uuendused on tehtud ja salvestatud, uueneb töövoog automaatselt, et kasutada uusimat Flow's saadaolevat API versiooni.

Võid probleemid ajutiselt ignoreerida, et teha kiireloomulisi muudatusi API versiooni ühilduvusvigadega töövoos. Kui neid probleeme ei lahendata, võib töövoo käivitamine peatuda või põhjustada vigu, kui Shopify enam vanemat API versiooni ei toeta.