Shopify Flow un GraphQL Admin API

Lietotne Flow izmanto Shopify GraphQL Admin API, lai izveidotu automatizācijas un integrācijas, kas paplašina un uzlabo Shopify administrēšanas paneli. Flow izmanto API 2026-01 versiju, lai novērtētu nosacījumus un mainīgos darbplūsmās, kā arī veiktu darbības tavā Shopify veikalā. Tā kā Flow piekļūst veikala datiem, izsaucot API, no Flow tev ir piekļuve gandrīz visiem API pieejamajiem laukiem.

Tā kā Shopify ik pēc 3 mēnešiem izlaiž jaunas API versijas, dažas darbplūsmas var būt nepieciešams atjaunināt, ja lauki tiek mainīti vai vairs netiek atbalstīti.

GraphQL Admin API izmantošana darbplūsmās

Lielākā daļa Flow darbību izmanto GraphQL Admin API, lai veiktu izmaiņas tavā Shopify veikalā. Piemēram, darbība Pievienot pasūtījuma tagus izmanto tagsAdd mutāciju. Darbība Sūtīt Admin API pieprasījumu var izmantot lielāko daļu mutāciju, tostarp tās, kas Flow vēl nav pieejamas kā darbības.

Veidojot darbplūsmas, bieži saskarsies ar lauku nosaukumiem un aprakstiem, kuru pamatā ir GraphQL Admin API sintakse. Piemēram, lai darbplūsmā noteiktu kopējo pārdodamo varianta daudzumu, jāizmanto mainīgais variants_item.inventoryQuantity. Cits piemērs: lai noteiktu atrašanās vietu, kurā klients pieteicās tavai e-pasta jaunumu vēstulei, jāizmanto mainīgais emailSubscriptionMethod.

Tev nav perfekti jāpārzina API, lai izveidotu darbplūsmas lietotnē Flow, taču neliela izpratne par mainīgo nosaukumiem un to definīcijām var palīdzēt izveidot nepieciešamo darbplūsmas loģiku. Piemēram, zinot atšķirību starp klienta displayName (redzamo vārdu) un firstName (vārdu), palīdzēsi darbplūsmai piekļūt pareizajiem datiem atkarībā no tā, kādiem nolūkiem vēlies tos izmantot. Katram mainīgajam, veidojot darbplūsmu, ir pievienotas definīcijas, un tu vari noklikšķināt uz , lai uzzinātu vairāk par jebkuru mainīgo vai definīciju.

Veikala dati un GraphQL Admin API

Darbplūsmas nosacījumos un darbībās izmanto datus no tava veikala. Flow piekļūst veikala datiem, izmantojot GraphQL Admin API, un tas nozīmē, ka tev ir piekļuve gandrīz visiem API laukiem. Ja darbībai nav nepieciešamo datu, ko nodrošina trigers vai darbība Iegūt datus, darbplūsma netiek izpildīta un tiek parādīts kļūdas ziņojums.

Piemēram, darbplūsma sākas ar trigeri Klients izveidots un importē klienta datus darbplūsmā. Ja šim trigerim seko darbība Pievienot pasūtījuma tagus, kam nepieciešami pasūtījuma, nevis klienta dati, darbplūsmā radīsies trūkstošo datu kļūda.

Tev var būt nepieciešams priekšskatīt datus vai pārskatīt API dokumentāciju, lai saprastu, ko izvada API un kas tiek izmantots pakalpojumā Flow, kā arī lai nodrošinātu, ka darbplūsma izvada gaidītos datus.

Lauku argumenti un GraphQL Admin API

Dažiem GraphQL Admin API laukiem ir nepieciešami argumenti – papildu parametri, kas sašaurina atgriezto datu apjomu. Piemēram, laukam product.inCollection ir nepieciešams kolekcijas id arguments, lai zinātu, kura kolekcija jāpārbauda. Bez tā lauks nevar atgriezt rezultātu.

Lietotnē Flow no šiem laukiem vari izveidot mainīgos, norādot nepieciešamo argumenta vērtību, ko pēc tam var izmantot darbplūsmā. Vari arī piešķirt mainīgajam pielāgotu nosaukumu, lai uz to būtu vieglāk atsaukties turpmākajās darbībās, piemēram, nosaucot product.inCollection(id: "gid://shopify/Collection/123456") par product.inSummerBestsellers.

Uzzini vairāk par mainīgo izveidi no laukiem ar argumentiem.

Lai izveidotu mainīgos no metalaukiem, lietotnē Flow nepieciešama papildu informācija, jo katra metalauka nosaukumvietu un atslēgu tu definē patstāvīgi, tāpēc argumenti vienmēr ir unikāli tavam veikalam. Uzzini vairāk par metalaukiem lietotnē Flow.

API versijas

Shopify ik pēc 3 mēnešiem izlaiž jaunas API versijas, un Flow pēc iespējas ātrāk ievieš jaunās versijas, taču var atpalikt no jaunākās versijas. Kad iespējams, izmaiņas starp versijām tiek atrisinātas automātiski, taču dažas izmaiņas var nebūt viennozīmīgas, tostarp šādās situācijās:

• Ja lauki tiek noņemti, bet netiek nodrošināts aizvietotājs, kas potenciāli ietekmē nosacījumu vai Liquid izvērtēšanu.
• Ja lauki var saturēt null vērtību, kas potenciāli ietekmē nosacījumu vai Liquid izvērtēšanu.
• Ja mainās enum vērtības vai tiek pievienoti jauni apvienojuma vai saskarnes tipi, kas potenciāli ietekmē Liquid vai kodu.
• Ja mainās mutācijas argumenti, kas potenciāli ietekmē darbību Sūtīt Admin API pieprasījumu konfigurāciju.

Dažas darbplūsmas var būt nepieciešams atjaunināt manuāli. Šajos gadījumos darbplūsmas var parādīt kļūdu Nepieciešams atjauninājums vai Neatbalstīts API, un novirzīt tevi uz attiecīgo API dokumentāciju, lai veiktās nepieciešamās izmaiņas darbplūsmu redaktorā. Kad šie atjauninājumi ir pabeigti un saglabāti, darbplūsma tiek automātiski atjaunināta, lai izmantotu lietotnē Flow pieejamo jaunāko API versiju.

Vari izvēlēties īslaicīgi ignorēt problēmas, lai veiktu steidzamas izmaiņas darbplūsmā ar API versijas saderības kļūdām. Ja šīs problēmas netiek novērstas, darbplūsmas izpilde var tikt pārtraukta vai var rasties kļūdas, kad Shopify vairs neatbalsta vecāko API versiju.