„Shopify Flow“ ir „GraphQL Admin API“

„Flow“ naudoja Shopify GraphQL Admin API automatizavimo procesams ir integracijoms, kurios išplečia ir patobulina „Shopify“ administratorių, kurti. „Flow“ naudoja API 2026-01 versiją darbo eigų sąlygoms ir kintamiesiems įvertinti bei veiksmams Jūsų „Shopify“ parduotuvėje atlikti. Kadangi „Flow“ prie parduotuvės duomenų jungiasi per API, „Flow“ programoje turite prieigą prie beveik visų API galimų laukų.

Kadangi „Shopify“ kas 3 mėnesius išleidžia naujas API versijas, kai kurias darbo eigas gali tekti atnaujinti, kai laukai pakeičiami arba nebenaudojami.

GraphQL Admin API naudojimas darbo eigose

Dauguma „Flow“ veiksmų naudoja „GraphQL Admin API“ pakeitimams Jūsų „Shopify“ parduotuvėje atlikti. Pavyzdžiui, veiksmas Pridėti užsakymo žymes naudoja tagsAdd „mutation“ operaciją. Veiksmas Siųsti „Admin API“ užklausą gali naudoti daugumą „mutation“ operacijų, įskaitant tas, kurios dar neprieinamos kaip veiksmai programoje „Flow“.

Kurdami darbo eigas, dažnai susidursite su laukų pavadinimais ir aprašais, pagrįstais „GraphQL Admin API“ sintakse. Pavyzdžiui, norėdami nustatyti bendrą parduodamą varianto kiekį darbo eigoje, naudotumėte kintamąjį variants_item.inventoryQuantity. Kitas pavyzdys: norėdami nustatyti vietą, kurioje klientas užsiprenumeravo Jūsų el. pašto naujienlaiškį, naudotumėte kintamąjį emailSubscriptionMethod.

Norint kurti darbo eigas su „Flow“ programėle, nebūtina puikiai išmanyti API, tačiau supratimas apie kintamųjų pavadinimus ir jų apibrėžtis gali padėti sukurti konkrečią norimą darbo eigos logiką. Pavyzdžiui, žinant skirtumą tarp kliento displayName ir jo firstName, Jūsų darbo eiga galės pasiekti tinkamus duomenis, priklausomai nuo to, kam norite juos naudoti. Apibrėžtys pateikiamos prie kiekvieno kintamojo, kai kuriate darbo eigą. Galite spustelėti piktogramą , kad sužinotumėte daugiau apie bet kurį kintamąjį ar apibrėžtį.

Parduotuvės duomenys ir GraphQL Admin API

Darbo eigos naudoja Jūsų parduotuvės duomenis sąlygose ir veiksmuose. „Flow“ pasiekia parduotuvės duomenis naudodama „GraphQL Admin API“, o tai reiškia, kad turite prieigą prie beveik visų API laukų. Jei veiksmas neturi reikiamų duomenų, kuriuos pateikia paleidiklis arba veiksmas Gauti duomenis, darbo eiga nepaleidžiama ir rodomas klaidos pranešimas.

Pavyzdžiui, darbo eiga prasideda su Sukurtas klientas paleidikliu ir importuoja kliento duomenis į darbo eigą. Jei po to paleidiklio seka veiksmas Pridėti užsakymo žymes, kuriam reikia užsakymo, o ne kliento duomenų, darbo eigoje įvyks duomenų trūkumo klaida.

Jums gali tekti peržiūrėti duomenis arba peržvelgti API dokumentaciją, kad suprastumėte, ką pateikia API ir naudoja „Flow“, ir kad užtikrintumėte, jog Jūsų darbo eiga pateikia laukiamus duomenis.

Laukų argumentai ir GraphQL Admin API

Kai kuriems GraphQL Admin API laukams reikia argumentų – papildomų parametrų, kurie susiaurina grąžinamus duomenis. Pavyzdžiui, product.inCollection laukui reikalingas kolekcijos id argumentas, kad jis žinotų, kurią kolekciją tikrinti. Be jo laukas negali grąžinti rezultato.

Programėlėje Flow iš šių laukų galite sukurti kintamuosius, pateikdami reikiamą argumento reikšmę, kurią vėliau bus galima naudoti darbo eigoje. Taip pat galite priskirti kintamajam pasirinktinį pavadinimą, kad vėlesniuose žingsniuose būtų lengviau į jį nurodyti, pavyzdžiui, pavadindami product.inCollection(id: "gid://shopify/Collection/123456") kaip product.inSummerBestsellers.

Sužinoti daugiau apie kintamųjų kūrimą iš laukų su argumentais.

Kuriant kintamuosius iš metalaukų, programėlėje Flow reikia papildomos informacijos, nes kiekvieno metalauko vardų sritį ir raktą apibrėžiate patys, todėl argumentai visada yra unikalūs jūsų parduotuvei. Sužinoti daugiau apie metalaukus programėlėje Flow.

API versijavimas

„Shopify“ kas 3 mėnesius išleidžia naujas API versijas, o „Flow“ jas pritaiko kuo greičiau, tačiau gali atsilikti nuo naujausios versijos. Kai įmanoma, versijų pakeitimai išsprendžiami automatiškai, tačiau kai kurie pakeitimai gali būti sudėtingesni, įskaitant bet kurią iš šių situacijų:

• Kai laukai pašalinami, bet nepateikiamas joks pakaitalas, tai gali paveikti, kaip vertinamos sąlygos arba „Liquid“.
• Kai laukai gali turėti nulinę reikšmę (angl. „nullable“), tai gali paveikti, kaip vertinamos sąlygos arba „Liquid“.
• Kai pasikeičia „enum“ reikšmės arba pridedami nauji „union“ ar „interface“ tipai, tai gali paveikti „Liquid“ arba kodą.
• Kai pasikeičia „mutation“ operacijų argumentai, tai gali paveikti veiksmų „Siųsti „Admin API“ užklausą“ konfigūraciją.

Kai kurias darbo eigas gali tekti atnaujinti rankiniu būdu. Tokiais atvejais darbo eigose gali būti rodomas klaidos pranešimas Reikalingas atnaujinimas arba Nepalaikoma API, ir Jūs būsite nukreipti į atitinkamą API dokumentaciją, kad atliktumėte reikiamus pakeitimus darbo eigos rengyklėje. Atlikus ir išsaugojus šiuos atnaujinimus, darbo eiga automatiškai atsinaujins ir naudos naujausią „Flow“ pasiekiamą API versiją.

Galite laikinai nepaisyti problemų, kad atliktumėte skubius pakeitimus darbo eigoje, kurioje yra API versijos suderinamumo klaidų. Jei šios problemos nebus išspręstos, darbo eiga gali nustoti veikti arba sukelti klaidų, kai „Shopify“ nebepalaikys senesnės API versijos.