Shopify Flow și GraphQL Admin API

Flow utilizează Shopify GraphQL Admin API pentru a crea automatizări și integrări care extind și îmbunătățesc panoul de administrare Shopify. Flow utilizează versiunea 2026-01 a API-ului pentru a evalua condițiile și variabilele din fluxurile de lucru, precum și pentru a efectua acțiuni în magazinul dvs. Shopify. Deoarece Flow accesează datele magazinului prin apelarea API-ului, aveți acces la aproape toate câmpurile disponibile în API din Flow.

Deoarece Shopify lansează noi versiuni API la fiecare 3 luni, unele fluxuri de lucru ar putea necesita actualizare atunci când câmpurile sunt modificate sau depreciate.

Utilizarea GraphQL Admin API în fluxurile de lucru

Majoritatea acțiunilor din Flow utilizează GraphQL Admin API pentru a efectua modificări în magazinul dvs. Shopify. De exemplu, acțiunea Adăugare etichete de comandă utilizează mutația tagsAdd. Acțiunea Trimitere solicitare Admin API poate utiliza majoritatea mutațiilor, inclusiv pe cele care nu sunt încă disponibile ca acțiuni în Flow.

Pe măsură ce creați fluxuri de lucru, veți întâlni adesea nume de câmpuri și descrieri bazate pe sintaxa GraphQL Admin API. De exemplu, pentru a determina cantitatea totală vandabilă a unei variante într-un flux de lucru, ați utiliza variabila variants_item.inventoryQuantity. Alt exemplu, pentru a determina locația în care un client s-a abonat la buletinul dvs. informativ prin e-mail, ați utiliza variabila emailSubscriptionMethod.

Nu trebuie să cunoașteți în detaliu API-ul pentru a crea fluxuri de lucru cu aplicația Flow, dar înțelegerea numelor variabilelor și a definițiilor acestora vă poate ajuta să construiți logica specifică a fluxului de lucru pe care o doriți. De exemplu, cunoașterea diferenței dintre displayName al unui client și firstName al acestuia poate ajuta fluxul de lucru să acceseze datele corecte, în funcție de scopul în care doriți să le utilizați. Definițiile sunt incluse cu fiecare variabilă pe măsură ce construiți fluxul de lucru și puteți face clic pe pentru a afla mai multe despre orice variabilă sau definiție.

Datele magazinului și GraphQL Admin API

Fluxurile de lucru utilizează date din magazinul dvs. în condiții și acțiuni. Flow accesează datele magazinului utilizând GraphQL Admin API, ceea ce înseamnă că aveți acces la aproape toate câmpurile din API. Dacă o acțiune nu are datele necesare furnizate de declanșator sau de o acțiune Obținere date, atunci fluxul de lucru nu se execută și se afișează un mesaj de eroare.

De exemplu, un flux de lucru pornește cu un declanșator Client creat și importă datele clientului în fluxul de lucru. Dacă acel declanșator este urmat de o acțiune Adăugare etichete de comandă, care necesită date despre comandă și nu date despre client, atunci fluxul de lucru va genera o eroare de date lipsă.

Este posibil să fie necesar să previzualizați datele sau să consultați documentația API pentru a înțelege ce este generat de API și utilizat în Flow și pentru a vă asigura că fluxul de lucru generează datele pe care le așteptați.

Argumentele câmpului și GraphQL Admin API

Anumite câmpuri GraphQL Admin API necesită argumente, parametri suplimentari care restrâng datele returnate. De exemplu, câmpul product.inCollection are nevoie de argumentul id al unei colecții pentru a ști ce colecție să verifice. Fără acesta, câmpul nu poate returna un rezultat.

În Flow, puteți crea variabile din aceste câmpuri furnizând valoarea argumentului necesar, care poate fi apoi utilizată în fluxul de lucru. Puteți, de asemenea, să atribuiți un nume personalizat variabilei pentru a fi mai ușor de referențiat în pașii următori, de exemplu, numind product.inCollection(id: "gid://shopify/Collection/123456") ca product.inSummerBestsellers.

Află mai multe despre crearea de variabile din câmpuri cu argumente.

Crearea de variabile din metacâmpuri necesită informații suplimentare în Flow deoarece dumneavoastră definiți spațiul de nume și cheia fiecărui metacâmp, deci argumentele sunt întotdeauna unice pentru magazinul dumneavoastră. Află mai multe despre metacâmpuri în Flow.

Versionarea API

Shopify lansează noi versiuni API la fiecare 3 luni, iar Flow adoptă noile versiuni cât mai curând posibil, dar ar putea fi în urmă față de cea mai recentă versiune. Atunci când este posibil, modificările între versiuni sunt rezolvate automat, dar unele modificări s-ar putea să nu fie simple, inclusiv în oricare dintre următoarele situații:

• Când câmpurile sunt eliminate, dar nu este furnizat niciun înlocuitor, afectând potențial modul în care sunt evaluate condițiile sau Liquid.
• Când câmpurile devin anulabile, afectând potențial modul în care sunt evaluate condițiile sau Liquid.
• Când valorile enum se modifică sau sunt adăugate noi tipuri de uniune sau interfață, afectând potențial Liquid sau codul.
• Când argumentele mutației se modifică, afectând potențial configurația acțiunilor Trimitere solicitare Admin API.

Unele fluxuri de lucru ar putea necesita actualizare manuală. În aceste cazuri, fluxurile de lucru ar putea afișa o eroare Necesită actualizare sau API neacceptat și vă pot ghida către documentația API relevantă pentru a efectua modificările necesare în editorul de fluxuri de lucru. Când aceste actualizări sunt finalizate și salvate, fluxul de lucru se actualizează automat pentru a utiliza cea mai recentă versiune API disponibilă în Flow.

Puteți alege să ignorați temporar problemele pentru a efectua modificări urgente într-un flux de lucru cu erori de compatibilitate a versiunii API. Dacă aceste probleme nu sunt rezolvate, atunci fluxul de lucru s-ar putea să nu mai ruleze sau să provoace erori atunci când versiunea mai veche a API-ului nu mai este acceptată de Shopify.