Shopify Flow in GraphQL Admin API

Flow uporablja GraphQL Admin API platforme Shopify za gradnjo avtomatizacij in integracij, ki razširijo in izboljšajo skrbnika Shopify. Flow za ovrednotenje pogojev in spremenljivk v potekih dela ter izvajanje dejanj v trgovini Shopify uporablja različico API-ja 2026-01. Ker Flow dostopa do podatkov trgovine s klicem API-ja, imate v storitvi Flow dostop do skoraj vseh polj, ki so na voljo v API-ju.

Ker Shopify vsake 3 mesece izda nove različice API-ja, bo ob spremembi ali ukinitvi polj nekatere poteke dela morda treba posodobiti.

Na tej strani

Uporaba vmesnika GraphQL Admin API v potekih dela

Večina dejanj v storitvi Flow uporablja GraphQL Admin API za uvajanje sprememb v vaši trgovini Shopify. Na primer, dejanje Dodaj oznake naročila uporabi mutacijo tagsAdd. Dejanje Pošlji zahtevo za Admin API lahko uporablja večino mutacij, vključno s tistimi, ki v storitvi Flow še niso na voljo kot dejanja.

Pri ustvarjanju potekov dela boste pogosto naleteli na imena in opise polj, ki temeljijo na sintaksi vmesnika GraphQL Admin API. Za določanje skupne količine različice, primerne za prodajo, v poteku dela bi na primer uporabili spremenljivko variants_item.inventoryQuantity. Za določanje lokacije, kjer se je stranka prijavila na vaše e-poštno glasilo, pa bi na primer uporabili spremenljivko emailSubscriptionMethod.

Za ustvarjanje potekov dela v aplikaciji Flow vam ni treba podrobno poznati API-ja, vendar pa vam lahko osnovno razumevanje imen in definicij spremenljivk pomaga pri gradnji specifične logike poteka dela, ki si jo želite. Poznavanje razlike med displayName (prikaznim imenom) in firstName (imenom) stranke na primer omogoča, da potek dela dostopa do pravih podatkov glede na vaš namen uporabe. Definicije so priložene vsaki spremenljivki med gradnjo poteka dela, s klikom na pa lahko izveste več o katerikoli spremenljivki ali definiciji.

Podatki o trgovini in GraphQL Admin API

Poteki dela v pogojih in dejanjih uporabljajo podatke iz vaše trgovine. Flow do podatkov trgovine dostopa prek vmesnika GraphQL Admin API, kar pomeni, da imate dostop do skoraj vseh polj v API-ju. Če dejanje nima potrebnih podatkov, ki jih posreduje sprožilec ali dejanje Pridobi podatke, se potek dela ne izvede in prikaže se sporočilo o napaki.

Potek dela se na primer začne s sprožilcem Ustvarjena stranka in v potek dela uvozi podatke o stranki. Če temu sprožilcu sledi dejanje Dodaj oznake naročila, ki ne zahteva podatkov o stranki, temveč podatke o naročilu, potek dela vrne napako zaradi manjkajočih podatkov.

Za razumevanje tega, kaj API vrne in se uporabi v storitvi Flow, boste morda morali predogledati podatke ali pa pregledati dokumentacijo za API ter tako zagotoviti, da potek dela vrne pričakovane podatke.

Argumenti polj in GraphQL Admin API

Nekatera polja vmesnika GraphQL Admin API zahtevajo argumente, to so dodatni parametri, ki zamejijo vrnjene podatke. Za polje product.inCollection je na primer potreben argument id zbirke, da ve, katero zbirko je treba preveriti. Brez njega polje ne more vrniti rezultata.

V aplikaciji Flow lahko iz teh polj ustvarite spremenljivke tako, da navedete zahtevano vrednost argumenta, ki jo nato lahko uporabite v poteku dela. Spremenljivki lahko dodelite tudi ime po meri, da se boste nanjo lažje sklicevali v naslednjih korakih, na primer tako, da product.inCollection(id: "gid://shopify/Collection/123456") poimenujete kot product.inSummerBestsellers.

Več informacij o ustvarjanju spremenljivk iz polj z argumenti.

Za ustvarjanje spremenljivk iz metapolj so v aplikaciji Flow potrebne dodatne informacije, saj imenski prostor in ključ vsakega metapolja določite sami, zato so argumenti vedno edinstveni za vašo trgovino. Več informacij o metapoljih v aplikaciji Flow.

Določanje različic API-ja

Shopify vsake 3 mesece izda nove različice API-ja in Flow nove različice sprejme čim prej, vendar lahko zaostaja za najnovejšo različico. Kadar je mogoče, se spremembe med različicami razrešijo samodejno, vendar nekatere spremembe morda niso preproste, kar vključuje katero koli od naslednjih situacij:

Ko so polja odstranjena in ni na voljo zamenjave, kar lahko vpliva na ocenjevanje pogojev ali kode Liquid.
Ko polja postanejo ničelna (nullable), kar lahko vpliva na ocenjevanje pogojev ali kode Liquid.
Ko se spremenijo vrednosti oštevilčenja ali so dodane nove vrste unij ali vmesnikov, kar lahko vpliva na kodo Liquid ali drugo kodo.
Ko se spremenijo argumenti mutacije, kar lahko vpliva na konfiguracijo dejanj za pošiljanje zahteve za Admin API (Send Admin API request).

Nekatere poteke dela bo morda treba posodobiti ročno. V teh primerih se lahko v potekih dela prikaže napaka Update required (Potrebna je posodobitev) ali Unsupported API (Nepodprt API), ki vas usmeri na ustrezno dokumentacijo za API, da v urejevalniku poteka dela izvedete potrebne spremembe. Ko so te posodobitve dokončane in shranjene, se potek dela samodejno posodobi tako, da uporablja najnovejšo različico API-ja, ki je na voljo v aplikaciji Flow.

Težave lahko začasno prezrete, da izvedete nujne spremembe v poteku dela z napakami o združljivosti različice API-ja. Če teh težav ne odpravite, lahko potek dela preneha delovati ali povzroča napake, ko Shopify ne bo več podpiral starejše različice API-ja.