Shopify Flow eta GraphQL Admin API

Flow-k Shopify GraphQL Admin API erabiltzen du Shopify-ko administratzailea zabaltzen eta hobetzen duten automatizazioak eta integrazioak eraikitzeko. Flow-k APIaren 2026-01 bertsioa erabiltzen du lan-fluxuetan baldintzak eta aldagaiak ebaluatzeko nahiz zure Shopify-ko dendan ekintzak gauzatzeko. Flow-k dendako datuetara sartzeko APIari dei egiten dionez, APIan erabilgarri dauden ia eremu guztietarako sarbidea duzu Flow-tik.

Shopify-k 3 hilean behin APIaren bertsio berriak kaleratzen dituenez, baliteke lan-fluxu batzuk eguneratu behar izatea eremuak aldatzen edo zaharkituta geratzen direnean.

GraphQL Admin API erabiltzea lan-fluxuetan

Flow-eko ekintza gehienek GraphQL Admin API erabiltzen dute zure Shopify-ko dendan aldaketak egiteko. Adibidez, Gehitu eskaera-etiketak ekintzak tagsAdd mutazioa erabiltzen du. Bidali Admin API eskaera ekintzak mutazio gehienak erabil ditzake, baita Flow-en ekintza gisa oraindik erabilgarri ez daudenak ere.

Lan-fluxuak sortu ahala, maiz agertuko dira GraphQL Admin APIaren sintaxian oinarritutako eremuen izenak eta deskribapenak. Adibidez, lan-fluxu batean aldaera baten sal daitekeen kopuru osoa zehazteko, variants_item.inventoryQuantity aldagaia erabil dezakezu. Edo, bezero batek zure posta elektronikoko buletinean harpidetzeko erabili duen kokapena zehazteko, emailSubscriptionMethod aldagaia.

Ez duzu APIan aditua izan beharrik Flow aplikazioarekin lan-fluxuak sortzeko, baina aldagaien izenei eta horien definizioei buruz apur bat jakiteak nahi duzun lan-fluxuaren logika zehatza eraikitzen lagun zaitzake. Adibidez, bezero baten displayName eta firstName aldagaien arteko aldea jakiteak datu zuzenak atzitzen lagun diezaioke lan-fluxuari, zertarako erabili nahi duzun kontuan hartuta. Definizioak aldagai bakoitzarekin sartzen dira lan-fluxua eraiki ahala, eta sakatu dezakezu edozein aldagai edo definiziori buruzko informazio gehiago lortzeko.

Dendaren datuak eta GraphQL Admin APIa

Lan-fluxuek dendako datuak erabiltzen dituzte baldintzetan eta ekintzetan. Flow-ek GraphQL Admin APIa erabiliz atzitzen ditu dendako datuak; horrek esan nahi du APIko ia eremu guztietarako sarbidea duzula. Ekintza batek ez baditu abiarazleak edo Eskuratu datuak ekintza batek emandako beharrezko datuak, lan-fluxua ez da exekutatzen eta errore-mezu bat bistaratzen da.

Adibidez, lan-fluxu bat Bezeroa sortu da abiarazlearekin hasten da, eta bezeroaren datuak lan-fluxura inportatzen ditu. Abiarazle horren atzetik Gehitu eskaera-etiketak ekintza badator (zeinak eskaeraren datuak behar baititu eta ez bezeroarenak), lan-fluxuak errore bat emango du datuak falta direlako.

Agian datuak aurreikusi beharko dituzu, edo APIaren dokumentazioa berrikusi, APIak zer ematen duen eta Flow-en zer erabiltzen den ulertzeko; horrela, lan-fluxuak zuk espero dituzun datuak ematen dituela ziurtatuko duzu.

Eremuen argumentuak eta GraphQL Admin APIa

GraphQL Admin APIaren eremu batzuek argumentuak behar dituzte; hots, itzulitako datuak mugatzen dituzten parametro gehigarriak. Adibidez, product.inCollection eremuak bildumaren id argumentua behar du, zein bilduma egiaztatu behar den jakiteko. Hori gabe, eremuak ezin du emaitzarik itzuli.

Flow-en, eremu horietatik aldagaiak sor ditzakezu eskatutako argumentuaren balioa emanda, eta horiek lan-fluxuan erabili ahal izango dira gero. Aldagaiari izen pertsonalizatu bat ere eslei diezaiokezu, hurrengo urratsetan errazago aipatzeko; adibidez, product.inCollection(id: "gid://shopify/Collection/123456") aldagaiari product.inSummerBestsellers izena emanda.

Lortu informazio gehiago argumentuak dituzten eremuetatik aldagaiak sortzeari buruz.

Metaeremuetatik aldagaiak sortzeak informazio gehigarria eskatzen du Flow-en, metaeremu bakoitzaren izen-espazioa eta gakoa zeuk zehazten baitituzu; beraz, argumentuak beti dira bakarrak zure dendarako. Lortu informazio gehiago Flow-eko metaeremuei buruz.

APIen bertsioak

Shopify-k APIen bertsio berriak kaleratzen ditu 3 hilez behin, eta Flow-ek ahalik eta lasterren hartzen ditu bertsio berriak, baina baliteke azken bertsioaren atzetik ibiltzea. Ahal denean, bertsioen arteko aldaketak automatikoki ebazten dira, baina baliteke aldaketa batzuk sinpleak ez izatea, honako egoera hauetan barne:

• Eremuak kentzen direnean baina ez denean ordezkorik ematen; horrek baldintzak edo Liquid nola ebaluatzen diren eragin dezake.
• Eremuak nulu bihur daitezkeenean; horrek baldintzak edo Liquid nola ebaluatzen diren eragin dezake.
• Enum balioak aldatzen direnean, edo elkarketa- edo interfaze-mota berriak gehitzen direnean; horrek Liquid nahiz kodeari eragin diezaioke.
• Mutazio-argumentuak aldatzen direnean; horrek "Bidali Admin API eskaera" ekintzen konfigurazioari eragin diezaioke.

Baliteke lan-fluxu batzuk eskuz eguneratu behar izatea. Kasu horietan, lan-fluxuek Eguneratu behar da edo Onartu gabeko APIa errorea bistara dezakete, eta dagokion APIaren dokumentaziora bideratuko zaituzte, lan-fluxuaren editorean beharrezko aldaketak egiteko. Eguneratze horiek osatu eta gordetzen direnean, lan-fluxua automatikoki eguneratzen da Flow-en erabilgarri dagoen azken API bertsioa erabiltzeko.

Arazoei aldi baterako ez ikusiarena egitea hauta dezakezu, API bertsioen bateragarritasun-erroreak dituen lan-fluxu batean premiazko aldaketak egiteko. Arazo horiek konpontzen ez badira, lan-fluxua agian ez da gehiago exekutatuko edo erroreak eragingo ditu Shopify-k APIaren bertsio zaharragoa onartzeari uzten dionean.