Shopify Flow a GraphQL Admin API

Aplikácia Flow používa rozhranie Shopify GraphQL Admin API na vytváranie automatizácií a integrácií, ktoré rozširujú a vylepšujú administrátora Shopify. Flow používa verziu rozhrania API 2026-01 na vyhodnocovanie podmienok a premenných v pracovných postupoch a na vykonávanie akcií vo vašom obchode Shopify. Keďže aplikácia Flow pristupuje k údajom obchodu volaním rozhrania API, prostredníctvom aplikácie Flow máte prístup k takmer všetkým poliam dostupným v rozhraní API.

Keďže platforma Shopify vydáva nové verzie rozhrania API každé 3 mesiace, pri zmene polí alebo ukončení ich podpory bude možno potrebné niektoré pracovné postupy aktualizovať.

Používanie rozhrania GraphQL Admin API v pracovných postupoch

Väčšina akcií v aplikácii Flow používa na vykonávanie zmien vo vašom obchode Shopify rozhranie GraphQL Admin API. Napríklad akcia Pridať značky objednávky používa mutáciu tagsAdd. Akcia Odoslať požiadavku na rozhranie Admin API dokáže použiť väčšinu mutácií vrátane tých, ktoré v aplikácii Flow ešte nie sú k dispozícii ako akcie.

Pri vytváraní pracovných postupov sa často stretnete s názvami a popismi polí založenými na syntaxi rozhrania GraphQL Admin API. Napríklad na zistenie celkového predajného množstva variantu v pracovnom postupe použijete premennú variants_item.inventoryQuantity. Ďalším príkladom je, že na zistenie lokality, kde sa zákazník prihlásil na odber vášho e-mailového newslettra, použijete premennú emailSubscriptionMethod.

Na vytváranie pracovných postupov pomocou aplikácie Flow nemusíte byť expertom na rozhranie API. Určitá znalosť názvov premenných a ich definícií vám však pomôže vytvoriť presne takú logiku pracovného postupu, akú potrebujete. Ak napríklad poznáte rozdiel medzi poľom zákazníka displayName a firstName, pomôže to vášmu pracovnému postupu získať prístup k správnym údajom v závislosti od toho, na čo ich chcete použiť. Pri vytváraní pracovného postupu sa ku každej premennej zobrazujú definície. Kliknutím na ikonu si môžete zobraziť ďalšie informácie o akejkoľvek premennej alebo definícii.

Údaje obchodu a GraphQL Admin API

Pracovné postupy využívajú údaje z vášho obchodu v podmienkach a akciách. Aplikácia Flow pristupuje k údajom obchodu prostredníctvom rozhrania GraphQL Admin API, čo znamená, že máte prístup k takmer všetkým poliam v rozhraní API. Ak akcia nemá potrebné údaje poskytnuté spúšťačom alebo akciou Získať údaje, pracovný postup sa nespustí a zobrazí sa chybové hlásenie.

Predpokladajme napríklad, že pracovný postup začína spúšťačom Customer created (Vytvorený zákazník) a do pracovného postupu sa importujú údaje zákazníka. Ak po tomto spúšťači nasleduje akcia Add order tags (Pridať značky objednávky), ktorá vyžaduje údaje o objednávke, nie údaje o zákazníkoch, pracovný postup vygeneruje chybu týkajúcu sa chýbajúcich údajov.

Možno budete musieť zobraziť ukážku údajov alebo si pozrieť dokumentáciu k rozhraniu API, aby ste pochopili, aký výstup rozhranie API produkuje a požíva v aplikácii Flow, a aby ste sa uistili, že váš pracovný postup generuje očakávané údaje.

Argumenty polí a GraphQL Admin API

Niektoré polia rozhrania GraphQL Admin API vyžadujú argumenty, čo sú dodatočné parametre zužujúce výber vrátených údajov. Napríklad pole product.inCollection potrebuje argument id kolekcie, aby zistilo, ktorú kolekciu má skontrolovať. Bez neho nemôže pole vrátiť žiadny výsledok.

V aplikácii Flow môžete z týchto polí vytvoriť premenné zadaním požadovanej hodnoty argumentu, ktorú potom možno použiť v pracovnom postupe. Premennej môžete tiež priradiť vlastný názov, aby ste na ňu mohli v nasledujúcich krokoch jednoduchšie odkazovať, napríklad pomenovaním product.inCollection(id: "gid://shopify/Collection/123456") ako product.inSummerBestsellers.

Ďalšie informácie o vytváraní premenných z polí s argumentmi.

Vytváranie premenných z metapolí vyžaduje v aplikácii Flow ďalšie informácie, pretože menný priestor a kľúč každého metapoľa definujete sami. Argumenty sú tak pre váš obchod vždy jedinečné. Ďalšie informácie o metapoliach v aplikácii Flow.

Verziovanie rozhrania API

Spoločnosť Shopify vydáva nové verzie rozhrania API každé 3 mesiace a aplikácia Flow tieto nové verzie prijíma čo najskôr. Môže sa však stať, že za najnovšou verziou zaostane. Keď je to možné, zmeny medzi verziami sa riešia automaticky. Niektoré zmeny však nemusia byť priamočiare. Patria sem nasledujúce situácie:

• Ak sa odstránia polia, ale neposkytne sa žiadna náhrada, čo môže ovplyvniť vyhodnocovanie podmienok alebo jazyka Liquid.
• Ak polia začnú nadobúdať hodnotu null, čo môže ovplyvniť vyhodnocovanie podmienok alebo jazyka Liquid.
• Ak sa zmenia hodnoty typu enum alebo sa pridajú nové typy únií alebo rozhraní, čo môže ovplyvniť jazyk Liquid alebo kód.
• Ak sa zmenia argumenty mutácie, čo môže ovplyvniť konfiguráciu akcií na odoslanie žiadosti rozhraniu Admin API.

Niektoré pracovné postupy bude možno potrebné aktualizovať manuálne. V takýchto prípadoch sa v pracovných postupoch môže zobraziť chyba Vyžaduje sa aktualizácia alebo Nepodporované rozhranie API. V takom prípade vás usmernia do príslušnej dokumentácie k rozhraniu API, kde v editore pracovných postupov vykonáte požadované zmeny. Po dokončení a uložení týchto aktualizácií sa pracovný postup automaticky zaktualizuje, aby používal najnovšiu verziu rozhrania API, ktorá je v aplikácii Flow dostupná.

Môžete sa rozhodnúť problémy dočasne ignorovať a vykonať naliehavé zmeny pracovného postupu aj s chybami týkajúcimi sa kompatibility verzie rozhrania API. Ak sa však tieto problémy nevyriešia, po ukončení podpory staršej verzie rozhrania API spoločnosťou Shopify môže pracovný postup prestať fungovať alebo môže spôsobiť chyby.