Shopify Flow ja GraphQL Admin API

Flow käyttää Shopify GraphQL Admin APIa sellaisten automaatioiden ja integraatioiden luomiseen, jotka laajentavat ja tehostavat Shopifyn ohjausnäkymää. Flow käyttää API:n versiota 2026-01 arvioidakseen työnkulkujen ehtoja ja muuttujia sekä tehdäkseen toimintoja Shopify-kaupassasi. Koska Flow käyttää kaupan dataa kutsumalla APIa, sinulla on Flow'n kautta pääsy lähes kaikkiin API:ssa saatavilla oleviin kenttiin.

Koska Shopify julkaisee uusia API-versioita kolmen kuukauden välein, joitakin työnkulkuja on ehkä päivitettävä, kun kenttiä muutetaan tai ne poistetaan käytöstä.

GraphQL Admin APIn käyttäminen työnkuluissa

Useimmat Flow'n toiminnot käyttävät GraphQL Admin APIa muutosten tekemiseen Shopify-kaupassasi. Esimerkiksi Lisää tilauksen tunnisteita -toiminto käyttää tagsAdd-muuntoa. Lähetä Admin API -pyyntö -toiminto voi käyttää useimpia muuntoja, mukaan lukien niitä, jotka eivät ole vielä saatavilla toimintoina Flow'ssa.

Kun luot työnkulkuja, törmäät usein kenttien nimiin ja kuvauksiin, jotka perustuvat GraphQL Admin APIn syntaksiin. Esimerkiksi, jos haluat määrittää työnkulussa tuoteversion myyntikelpoisen kokonaismäärän, käytät variants_item.inventoryQuantity-muuttujaa. Toinen esimerkki on, että jos haluat määrittää sijainnin, jossa asiakas tilasi uutiskirjeesi, käytät emailSubscriptionMethod-muuttujaa.

Sinun ei tarvitse hallita APIa sujuvasti luodaksesi työnkulkuja Flow-sovelluksella, mutta muuttujien nimien ja niiden määritelmien ymmärtäminen auttaa sinua rakentamaan haluamasi työnkulun logiikan. Esimerkiksi, kun tiedät asiakkaan displayName- ja firstName-kenttien eron, työnkulkusi voi käyttää oikeita tietoja riippuen siitä, mihin haluat niitä käyttää. Määritelmät sisältyvät jokaiseen muuttujaan, kun rakennat työnkulkua, ja voit napsauttaa -kuvaketta saadaksesi lisätietoja mistä tahansa muuttujasta tai määritelmästä.

Kaupan data ja GraphQL Admin API

Työnkulut käyttävät kauppasi dataa ehdoissa ja toiminnoissa. Flow käyttää kaupan dataa GraphQL Admin APIn kautta, mikä tarkoittaa, että sinulla on pääsy lähes kaikkiin APIn kenttiin. Jos toiminnolla ei ole käynnistimen tai Hae dataa -toiminnon tarjoamaa tarvittavaa dataa, työnkulkua ei suoriteta ja näyttöön tulee virheilmoitus.

Esimerkiksi työnkulku alkaa Asiakas luotu -käynnistimellä ja tuo asiakastiedot työnkulkuun. Jos tätä käynnistintä seuraa Lisää tilauksen tunnisteita -toiminto, joka vaatii tilausdataa eikä asiakasdataa, työnkulku aiheuttaa puuttuvan datan virheen.

Sinun on ehkä esikatseltava dataa tai tarkistettava API-dokumentaatio ymmärtääksesi, mitä API tuottaa ja mitä Flow käyttää, ja varmistaaksesi, että työnkulkusi tuottaa odottamasi datan.

Kenttien argumentit ja GraphQL Admin API

Jotkin GraphQL Admin API -kentät edellyttävät argumentteja eli lisäparametreja, jotka rajaavat palautettavia tietoja. Esimerkiksi product.inCollection-kenttä tarvitsee kokoelman id-argumentin (tunnuksen) tietääkseen, minkä kokoelman se tarkistaa. Ilman sitä kenttä ei voi palauttaa tulosta.

Voit luoda Flow'ssa muuttujia näistä kentistä antamalla vaaditun argumentin arvon, jota voidaan sitten käyttää työnkulussa. Voit myös antaa muuttujalle mukautetun nimen, jotta siihen on helpompi viitata myöhemmissä vaiheissa, esimerkiksi nimeämällä kentän product.inCollection(id: "gid://shopify/Collection/123456") muotoon product.inSummerBestsellers.

Lue lisää muuttujien luomisesta argumentteja sisältävistä kentistä.

Muuttujien luominen metakentistä edellyttää lisätietoja Flow'ssa, koska määrität jokaisen metakentän nimiavaruuden ja avaimen itse, joten argumentit ovat aina yksilöllisiä kaupallesi. Lue lisää metakentistä Flow'ssa.

API-versiointi

Shopify julkaisee uusia API-versioita kolmen kuukauden välein, ja Flow ottaa uudet versiot käyttöön mahdollisimman pian, mutta se saattaa olla jäljessä uusimmasta versiosta. Versioiden väliset muutokset ratkaistaan mahdollisuuksien mukaan automaattisesti, mutta jotkin muutokset eivät välttämättä ole yksinkertaisia, kuten seuraavissa tilanteissa:

• Kun kenttiä poistetaan, mutta korvaavaa kenttää ei tarjota, mikä saattaa vaikuttaa siihen, miten ehdot tai Liquid arvioidaan.
• Kun kentistä tulee nollattavia, mikä saattaa vaikuttaa siihen, miten ehdot tai Liquid arvioidaan.
• Kun enum-arvot muuttuvat tai uusia union- tai interface-tyyppejä lisätään, mikä saattaa vaikuttaa Liquidiin tai koodiin.
• Kun muuntoargumentit muuttuvat, mikä saattaa vaikuttaa Lähetä Admin API -pyyntö -toimintojen määrityksiin.

Jotkin työnkulut saattavat vaatia manuaalisen päivityksen. Näissä tapauksissa työnkuluissa saattaa näkyä Päivitys vaaditaan- tai Tukematon API -virheilmoitus, ja ne ohjaavat sinut asianmukaiseen API-dokumentaatioon tekemään tarvittavat muutokset työnkulun editorissa. Kun nämä päivitykset on tehty ja tallennettu, työnkulku päivittyy automaattisesti käyttämään uusinta Flow'ssa saatavilla olevaa API-versiota.

Voit jättää ongelmat väliaikaisesti huomiotta tehdäksesi kiireellisiä muutoksia työnkulkuun, jossa on API-version yhteensopivuusvirheitä. Jos näitä ongelmia ei korjata, työnkulun suoritus saattaa lakata tai se saattaa aiheuttaa virheitä, kun Shopify ei enää tue vanhempaa API-versiota.