Pomoć
Prijavi se

Shopify Flow i GraphQL Admin API

Aplikacija Flow upotrebljava GraphQL Admin API platforme Shopify za izgradnju automatizacija i integracija koje proširuju i poboljšavaju administratorski alat za Shopify. Aplikacija Flow upotrebljava verziju API-ja 2026-01 za procjenu uvjeta i varijabli u tijekovima rada te za poduzimanje radnji u vašoj trgovini Shopify. Budući da Flow pristupa podacima trgovine pozivanjem API-ja, iz aplikacije Flow imate pristup gotovo svim poljima koja su dostupna u API-ju.

Budući da platforma Shopify svakih 3 mjeseca izdaje nove verzije API-ja, neke će tijekove rada možda trebati ažurirati ako se polja izmijene ili zastare.

Na ovoj stranici

Upotreba sučelja GraphQL Admin API u tijekovima rada

Većina radnji u aplikaciji Flow upotrebljava GraphQL Admin API za unošenje promjena u vašu trgovinu Shopify. Na primjer, radnja Dodaj oznake narudžbe upotrebljava mutaciju tagsAdd. Radnja Pošalji zahtjev za Admin API može upotrijebiti većinu mutacija, uključujući one koje još nisu dostupne kao radnje u aplikaciji Flow.

Prilikom izrade tijekova rada često ćete nailaziti na nazive polja i opise temeljene na sintaksi sučelja GraphQL Admin API. Na primjer, da biste odredili ukupnu količinu varijante za prodaju u nekom tijeku rada, upotrijebili biste varijablu variants_item.inventoryQuantity. Za još jedan primjer, da biste odredili lokaciju na kojoj se korisnik pretplatio na vaš e-letak, upotrijebili biste varijablu emailSubscriptionMethod.

Ne morate biti stručnjak za API da biste izrađivali tijekove rada s pomoću aplikacije Flow, no osnovno razumijevanje naziva varijabli i njihovih definicija može vam pomoći u izgradnji specifične logike tijeka rada koju želite. Na primjer, poznavanje razlike između varijable displayName i varijable firstName korisnika može pomoći vašem tijeku rada u pristupanju točnim podacima ovisno o tome za što ih želite upotrijebiti. Definicije su uključene u svaku varijablu pri izgradnji vašeg tijeka rada te možete kliknuti Informacije da biste saznali više o bilo kojoj varijabli ili definiciji.

Podaci o trgovini i GraphQL Admin API

Tijekovi rada koriste se podacima iz vaše trgovine u uvjetima i radnjama. Flow pristupa podacima trgovine uporabom sučelja GraphQL Admin API, što znači da imate pristup gotovo svim poljima u API-ju. Ako radnja nema potrebne podatke koje joj je pružio pokretač ili radnja za dohvaćanje podataka, tijek rada neće se pokrenuti i prikazat će se poruka o pogrešci.

Na primjer, tijek rada započinje pokretačem Korisnik izrađen i uvozi podatke korisnika u tijek rada. Ako nakon tog pokretača slijedi radnja Dodaj oznake narudžbe koja zahtijeva podatke o narudžbi, a ne podatke o korisniku, tijek rada rezultirat će pogreškom zbog nedostatka podataka.

Možda ćete morati pregledati podatke ili pročitati dokumentaciju za API kako biste razumjeli što API izbacuje i što se rabi u aplikaciji Flow te kako biste bili sigurni da vaš tijek rada daje podatke koje očekujete.

Argumenti polja i GraphQL Admin API

Neka polja u sučelju GraphQL Admin API zahtijevaju argumente, dodatne parametre koji sužavaju opseg vraćenih podataka. Na primjer, polje product.inCollection zahtijeva id kolekcije kao argument kako bi znalo koju kolekciju treba provjeriti. Bez njega to polje ne može vratiti rezultat.

U aplikaciji Flow iz tih polja možete izraditi varijable unosom potrebne vrijednosti argumenta, koje zatim možete upotrijebiti u tijeku rada. Varijabli možete dodijeliti i prilagođeni naziv radi lakšeg snalaženja u kasnijim koracima, na primjer, tako da varijablu product.inCollection(id: "gid://shopify/Collection/123456") nazovete product.inSummerBestsellers.

Saznajte više o izradi varijabli iz polja s argumentima.

Izrada varijabli iz metapolja zahtijeva dodatne informacije u aplikaciji Flow jer sami definirate prostor za ime i ključ svakog metapolja, pa su argumenti uvijek jedinstveni za vašu trgovinu. Saznajte više o metapoljima u aplikaciji Flow.

Verzije API-ja

Shopify izdaje nove verzije API-ja svaka 3 mjeseca i Flow usvaja nove verzije što je prije moguće, no možda neće uvijek upotrebljavati najnoviju verziju. Kada je to moguće, promjene između verzija rješavaju se automatski, no neke promjene možda neće biti jednostavne, uključujući bilo koju od sljedećih situacija:

  • Kada su polja uklonjena, a nije navedena zamjena, što potencijalno utječe na način na koji se procjenjuju uvjeti ili Liquid.
  • Kada polja mogu imati vrijednost null, što potencijalno utječe na način na koji se procjenjuju uvjeti ili Liquid.
  • Kada se promijene enum vrijednosti ili se dodaju nove vrste unija ili sučelja, što potencijalno utječe na Liquid ili kod.
  • Kada se promijene argumenti mutacije, što potencijalno utječe na konfiguraciju radnji slanja zahtjeva za Admin API.

Neke tijekove rada možda će trebati ručno ažurirati. U tim slučajevima tijekovi rada mogu prikazivati pogrešku Potrebno je ažuriranje ili Nepodržani API te vas uputiti na odgovarajuću dokumentaciju za API kako biste unijeli potrebne promjene u uređivaču tijeka rada. Kada su ta ažuriranja dovršena i spremljena, tijek rada automatski se ažurira na najnoviju verziju API-ja dostupnu u aplikaciji Flow.

Možete odlučiti privremeno zanemariti probleme kako biste unijeli hitne promjene u tijek rada s pogreškama u kompatibilnosti verzije API-ja. Ako se ti problemi ne riješe, tijek rada mogao bi se prestati izvoditi ili uzrokovati pogreške kada Shopify prestane podržavati stariju verziju API-ja.