Shopify Flow e a GraphQL Admin API

Flow usa a GraphQL Admin API de Shopify para crear automatizacións e integracións que amplían e melloran o administrador de Shopify. Flow utiliza a versión 2026-01 da API para avaliar condicións e variables nos fluxos de traballo, así como para realizar accións na túa tenda de Shopify. Como Flow accede aos datos da tenda ao chamar á API, desde Flow tes acceso a case todos os campos dispoñibles na API.

Debido a que Shopify lanza novas versións da API cada 3 meses, pode ser necesario actualizar algúns fluxos de traballo cando os campos se modifican ou quedan obsoletos.

Uso da GraphQL Admin API en fluxos de traballo

A maioría das accións de Flow usan a GraphQL Admin API para facer cambios na túa tenda de Shopify. Por exemplo, a acción Engadir etiquetas ao pedido usa a mutación tagsAdd. A acción Enviar solicitude da Admin API pode usar case todas as mutacións, incluídas as que aínda non están dispoñibles como accións en Flow.

Ao crear fluxos de traballo, a miúdo atoparás nomes e descricións de campos baseados na sintaxe da GraphQL Admin API. Por exemplo, para determinar a cantidade vendible total dunha variante nun fluxo de traballo, empregarías a variable variants_item.inventoryQuantity. Outro exemplo, para determinar a localización na que un cliente se subscribiu ao teu boletín informativo, empregarías a variable emailSubscriptionMethod.

Non necesitas ser un experto na API para crear fluxos de traballo coa aplicación Flow, pero entender un pouco os nomes das variables e as súas definicións pode axudarche a crear a lóxica específica do fluxo de traballo que desexas. Por exemplo, saber a diferenza entre o displayName e o firstName dun cliente pode axudar a que o teu fluxo de traballo acceda aos datos correctos segundo para que o queiras usar. As definicións inclúense en cada variable mentres creas o fluxo de traballo e podes facer clic en para obter máis información sobre calquera variable ou definición.

Datos da tenda e GraphQL Admin API

Os fluxos de traballo usan datos da túa tenda en condicións e accións. Flow accede aos datos da tenda mediante a GraphQL Admin API, polo que tes acceso a case todos os campos da API. Se unha acción non ten os datos necesarios proporcionados polo activador ou por unha acción de obter datos, o fluxo de traballo non se executará e amosarase unha mensaxe de erro.

Por exemplo, un fluxo de traballo comeza co activador Cliente creado e importa datos de clientes ao fluxo de traballo. Se este activador vai seguido dunha acción Engadir etiquetas ao pedido, a cal require datos do pedido e non do cliente, o fluxo de traballo producirá un erro por falta de datos.

Pode que teñas que previsualizar os datos ou revisar a documentación da API para comprender que datos xera a API e se usan en Flow e así garantir que o teu fluxo de traballo produza os datos que esperas.

Argumentos de campo e GraphQL Admin API

Algúns campos da GraphQL Admin API requiren argumentos, é dicir, parámetros adicionais que limitan os datos que se devolven. Por exemplo, o campo product.inCollection necesita un argumento de id da colección para saber que colección comprobar. Sen el, o campo non pode devolver ningún resultado.

En Flow, podes crear variables a partir destes campos proporcionando o valor de argumento necesario, as cales se poderán usar despois no fluxo de traballo. Tamén lle podes asignar un nome personalizado á variable para que sexa máis doado facer referencia a ela nos pasos posteriores, por exemplo, nomeando product.inCollection(id: "gid://shopify/Collection/123456") como product.inSummerBestsellers.

Obtén máis información sobre como crear variables a partir de campos con argumentos.

Crear variables a partir de metacampos require información adicional en Flow porque ti mesmo defines o espazo de nomes e a clave de cada metacampo, polo que os argumentos sempre son únicos para a túa tenda. Obtén máis información sobre os metacampos en Flow.

Versións da API

Shopify publica novas versións da API cada 3 meses e Flow adóptaas canto antes, pero é posible que vaia por detrás da última versión. Cando é posible, os cambios entre versións resólvense automaticamente, pero algúns poden non ser tan sinxelos, o que inclúe calquera das seguintes situacións:

• Cando se eliminan campos pero non se proporciona ningún substituto, o que pode afectar á forma na que se avalían as condicións ou Liquid.
• Cando os campos pasan a aceptar valores nulos, o que pode afectar á forma na que se avalían as condicións ou Liquid.
• Cando cambian os valores de enumeración ou se engaden novos tipos de unión ou de interface, o que pode afectar a Liquid ou ao código.
• Cando cambian os argumentos da mutación, o que pode afectar á configuración das accións de Enviar solicitude da Admin API.

Algúns fluxos de traballo poden precisar actualizacións manuais. Nestes casos, os fluxos de traballo poden amosar un erro de Actualización necesaria ou API non compatible e guiarte ata a documentación da API correspondente para facer os cambios necesarios no editor de fluxos de traballo. Cando estas actualizacións se completan e se gardan, o fluxo de traballo actualízase automaticamente para usar a versión da API máis recente que estea dispoñible en Flow.

Podes escoller ignorar os problemas temporalmente para facer cambios urxentes nun fluxo de traballo con erros de compatibilidade de versión da API. Se non se solucionan estes problemas, o fluxo de traballo podería deixar de executarse ou causar erros cando a versión máis antiga da API deixe de ser compatible con Shopify.