Shopify Flow et la GraphQL Admin API

Flow utilise l’API GraphQL Admin de Shopify pour créer des automatisations et des intégrations qui étendent et améliorent l’interface administrateur Shopify. Flow utilise la version 2026-01 de l’API pour évaluer les conditions et les variables dans les flux de travail, ainsi que pour effectuer des actions dans votre boutique Shopify. Puisque Flow accède aux données de la boutique en appelant l’API, vous avez accès à la quasi-totalité des champs disponibles dans l’API à partir de Flow.

Comme Shopify publie de nouvelles versions de l’API tous les 3 mois, certains flux de travail peuvent nécessiter une mise à jour lorsque des champs sont modifiés ou deviennent obsolètes.

Utilisation de l’API GraphQL Admin dans les flux de travail

La plupart des actions dans Flow utilisent l’API GraphQL Admin pour apporter des modifications à votre boutique Shopify. Par exemple, l’action Ajouter des balises de commande utilise la mutation tagsAdd. L’action Envoyer une requête d’API Admin peut utiliser la plupart des mutations, y compris celles qui ne sont pas encore disponibles en tant qu’actions dans Flow.

Lorsque vous créez des flux de travail, vous rencontrez souvent des noms de champs et des descriptions basés sur la syntaxe de l’API GraphQL Admin. Par exemple, pour déterminer la quantité totale vendable d’une variante dans un flux de travail, vous utiliseriez la variable variants_item.inventoryQuantity. Autre exemple : pour déterminer l’emplacement où un client s’est abonné à votre newsletter par e-mail, vous utiliseriez la variable emailSubscriptionMethod.

Vous n’avez pas besoin de maîtriser l’API pour créer des flux de travail avec l’application Flow, mais une certaine connaissance des noms de variables et de leurs définitions peut vous aider à élaborer la logique de flux de travail spécifique que vous souhaitez. Par exemple, le fait de connaître la différence entre le displayName d’un client et son firstName peut aider votre flux de travail à accéder aux bonnes données en fonction de l’utilisation que vous souhaitez en faire. Des définitions sont incluses avec chaque variable au fur et à mesure que vous créez votre flux de travail, et vous pouvez cliquer sur pour en savoir plus sur une variable ou une définition.

Données de la boutique et API GraphQL Admin

Les flux de travail utilisent les données de votre boutique dans les conditions et les actions. Flow accède aux données de la boutique à l’aide de l’API GraphQL Admin, ce qui signifie que vous avez accès à la quasi-totalité des champs de l’API. Si une action ne dispose pas des données nécessaires fournies par le déclencheur ou par une action Obtenir les données, le flux de travail ne s’exécute pas et un message d’erreur s’affiche.

Par exemple, un flux de travail commence par un déclencheur Client créé et importe les données du client dans le flux de travail. Si ce déclencheur est suivi d’une action Ajouter des balises de commande, qui nécessite des données de commande et non des données de client, le flux de travail entraînera une erreur de données manquantes.

Vous devrez peut-être afficher un aperçu des données ou consulter la documentation de l’API pour comprendre les données générées par l’API et utilisées dans Flow, et pour vous assurer que votre flux de travail génère les données attendues.

Arguments de champ et GraphQL Admin API

Certains champs de GraphQL Admin API nécessitent des arguments, des paramètres supplémentaires qui précisent les données renvoyées. Par exemple, le champ product.inCollection a besoin d’un argument id de collection pour savoir quelle collection vérifier. Sans cela, le champ ne peut pas renvoyer de résultat.

Dans Flow, vous pouvez créer des variables à partir de ces champs en fournissant la valeur de l’argument requis, qui peut ensuite être utilisée dans le flux de travail. Vous pouvez également attribuer un nom personnalisé à la variable pour la référencer plus facilement dans les étapes suivantes, par exemple en nommant product.inCollection(id: "gid://shopify/Collection/123456") comme product.inSummerBestsellers.

En savoir plus sur la création de variables à partir de champs avec des arguments.

La création de variables à partir de champs méta nécessite des informations supplémentaires dans Flow, car vous définissez vous-même l’espace de noms et la clé de chaque champ méta, de sorte que les arguments sont toujours uniques à votre boutique. En savoir plus sur les champs méta dans Flow.

Gestion des versions de l’API

Shopify publie de nouvelles versions de l’API tous les 3 mois et Flow adopte les nouvelles versions dès que possible, mais peut être en retard sur la dernière version. Lorsque c’est possible, les changements entre les versions sont résolus automatiquement, mais certains changements peuvent ne pas être simples, notamment dans les situations suivantes :

• Lorsque des champs sont supprimés sans qu’un remplacement soit fourni, cela peut affecter la manière dont les conditions ou le code Liquid sont évalués.
• Lorsque des champs deviennent nullables, cela peut affecter la manière dont les conditions ou le code Liquid sont évalués.
• Lorsque des valeurs d’énumération changent ou que de nouveaux types d’union ou d’interface sont ajoutés, cela peut affecter le code Liquid ou un autre code.
• Lorsque les arguments de mutation changent, cela peut affecter la configuration des actions Envoyer une requête d’API Admin.

Certains flux de travail peuvent nécessiter une mise à jour manuelle. Dans ces cas, les flux de travail peuvent afficher une erreur Mise à jour requise ou API non prise en charge et vous guider vers la documentation de l’API pertinente pour apporter les modifications nécessaires dans l’éditeur de flux de travail. Une fois ces mises à jour terminées et enregistrées, le flux de travail est automatiquement mis à jour pour utiliser la dernière version de l’API disponible dans Flow.

Vous pouvez choisir d’ignorer temporairement les problèmes pour apporter des modifications urgentes à un flux de travail présentant des erreurs de compatibilité de version d’API. Si ces problèmes ne sont pas résolus, le flux de travail risque de ne plus s’exécuter ou de provoquer des erreurs lorsque l’ancienne version de l’API ne sera plus prise en charge par Shopify.