Shopify Flow i la GraphQL Admin API

Flow fa servir la GraphQL Admin API de Shopify per crear automatitzacions i integracions que amplien i milloren el panell d'administració de Shopify. Flow utilitza la versió 2026-01 de l'API per avaluar les condicions i les variables dels fluxos de treball, així com per dur a terme accions a la teva botiga de Shopify. Com que Flow accedeix a les dades de la botiga enviant crides a l'API, des de Flow tindràs accés a pràcticament tots els camps disponibles de l'API.

Com que Shopify llança versions noves de l'API cada tres mesos, pot ser que calgui actualitzar alguns fluxos de treball quan els camps es canviïn o quedin obsolets.

Ús de la GraphQL Admin API en fluxos de treball

La majoria de les accions de Flow fan servir la GraphQL Admin API per fer canvis a la teva botiga de Shopify. Per exemple, l'acció Afegeix etiquetes de comanda fa servir la mutació tagsAdd. L'acció Envia sol·licitud a l'Admin API pot utilitzar la majoria de les mutacions, incloses les que encara no estan disponibles com a accions a Flow.

A mesura que crees fluxos de treball, sovint trobaràs noms de camps i descripcions basats en la sintaxi de la GraphQL Admin API. Per exemple, per determinar la quantitat total comercialitzable d'una variant en un flux de treball, utilitzaries la variable variants_item.inventoryQuantity. Un altre exemple: per determinar la ubicació on un client s'ha subscrit al teu butlletí informatiu per correu electrònic, utilitzaries la variable emailSubscriptionMethod.

No cal que dominis l'API per crear fluxos de treball amb l'aplicació Flow, però entendre una mica els noms de les variables i les seves definicions et pot ajudar a crear la lògica de flux de treball específica que vols. Per exemple, conèixer la diferència entre el displayName i el firstName d'un client pot ajudar el teu flux de treball a accedir a les dades correctes depenent de l'ús que vulguis donar-los. S'inclouen definicions a cada variable a mesura que crees el flux de treball, i pots fer clic a per saber-ne més sobre qualsevol variable o definició.

Dades de la botiga i la GraphQL Admin API

Els fluxos de treball utilitzen dades de la teva botiga a les condicions i accions. Flow accedeix a les dades de la botiga utilitzant la GraphQL Admin API, el qual significa que tens accés a gairebé tots els camps de l'API. Si una acció no té les dades necessàries proporcionades per l'esdeveniment desencadenant o per una acció Obtén dades, el flux de treball no s'executa i es mostra un missatge d'error.

Per exemple, un flux de treball s'inicia amb un esdeveniment desencadenant Client creat i importa les dades del client al flux de treball. Si aquest esdeveniment desencadenant va seguit d'una acció Afegeix etiquetes de comanda, que requereix dades de la comanda i no pas del client, el flux de treball donarà un error per falta de dades.

És possible que hagis de previsualitzar les dades o revisar la documentació de l'API per entendre què genera l'API i com s'utilitza a Flow per assegurar-te que el teu flux de treball genera les dades que esperes.

Arguments de camp i la GraphQL Admin API

Alguns camps de la GraphQL Admin API requereixen arguments, que són paràmetres addicionals que delimiten quines dades es retornen. Per exemple, el camp product.inCollection necessita un argument d'id de la col·lecció per saber quina col·lecció comprovar. Sense això, el camp no pot retornar cap resultat.

A Flow, pots crear variables a partir d'aquests camps si proporciones el valor de l'argument requerit, el qual es podrà utilitzar posteriorment al flux de treball. També pots assignar un nom personalitzat a la variable perquè sigui més fàcil fer-hi referència en passos posteriors; per exemple, anomenant product.inCollection(id: "gid://shopify/Collection/123456") com a product.inSummerBestsellers.

Obtén més informació sobre com crear variables a partir de camps amb arguments.

Per crear variables a partir de metacamps cal informació addicional a Flow, ja que ets tu qui defineix l'espai de noms i la clau de cada metacamp. En conseqüència, els arguments sempre són únics per a la teva botiga. Obtén més informació sobre els metacamps a Flow.

Versions de l'API

Shopify llança noves versions de l'API cada 3 mesos i Flow n'adopta les noves versions tan aviat com pot, però podria anar una versió endarrerit respecte a l'última llançada. Sempre que és possible, els canvis entre versions es resolen automàticament, però alguns poden no ser tan evidents. Això inclou qualsevol de les situacions següents:

• Quan s'eliminen camps però no es proporciona cap substitut, cosa que pot afectar l'avaluació de les condicions o de Liquid.
• Quan els camps esdevenen anul·lables, cosa que pot afectar l'avaluació de les condicions o de Liquid.
• Quan canvien els valors enum o s'afegeixen nous tipus d'unió o d'interfície, cosa que pot afectar Liquid o el codi.
• Quan canvien els arguments de mutació, cosa que pot afectar la configuració de les accions d'Envia sol·licitud a l'Admin API.

És possible que alguns fluxos de treball s'hagin d'actualitzar manualment. En aquests casos, els fluxos de treball podrien mostrar un error del tipus Requereix actualització o API no compatible, i et guiaran cap a la documentació de l'API corresponent perquè facis els canvis necessaris a l'editor del flux de treball. Quan s'hagin completat i desat aquestes actualitzacions, el flux de treball s'actualitzarà de manera automàtica per utilitzar l'última versió de l'API disponible a Flow.

Pots triar ignorar temporalment els problemes per fer canvis urgents a un flux de treball amb errors de compatibilitat de la versió de l'API. Si no es resolen aquests problemes, és possible que el flux de treball s'aturi i no s'executi o causi errors quan Shopify deixi de donar suport a la versió anterior de l'API.