Shopify Flow et GraphQL Admin API

Flow utilise Shopify GraphQL Admin API pour créer des automatisations et des intégrations qui enrichissent et étendent les fonctionnalités de l’interface administrateur Shopify. À l’heure actuelle, Flow utilise la version 2024-07 de l’API pour évaluer les conditions et les variables des flux de travail et réaliser diverses actions dans votre boutique Shopify. En interrogeant l’API pour accéder aux données de la boutique, Flow vous permet d’utiliser presque tous les champs que l’API met à disposition.

La plupart des actions de Flow font appel à l’API pour modifier votre boutique Shopify. Par exemple, l’action Ajouter des balises de commande utilise la mutation tagsAdd. L’action Envoyer une requête à l’API Admin peut exploiter la majorité des mutations, y compris celles qui ne sont pas encore intégrées comme actions disponibles dans Flow.

Lors de la création de flux de travail, vous rencontrerez régulièrement des noms de champs et des descriptions issus directement de l’API. Il pourrait être nécessaire de prévisualiser les données ou de consulter la documentation de l’API pour comprendre les éléments qu’elle génère et qui sont utilisés dans Flow, et pour vérifier que votre flux de travail produit bien les données attendues.

versions d’API

Shopify publie de nouvelles versions d’API tous les trois mois et Flow adopte les nouvelles versions dès que possible, mais pourrait être en retard sur la dernière version. Lorsque cela est possible, les modifications entre les versions sont résolues automatiquement, mais certaines modifications pourraient ne pas être simples, notamment : * Lorsque des champs sont supprimés, mais qu’aucun remplacement n’est fourni, ce qui peut affecter la manière dont les états ou Liquid sont évalués. * Lorsque les champs deviennent nullables, affectant potentiellement la manière dont les états ou Liquid sont évalués. * Lorsque les valeurs d’énumération changent ou que de nouveaux types d’union ou d’interface sont ajoutés, affectant potentiellement Liquid ou le code. * Lorsque les arguments de mutation changent, affectant potentiellement la configuration des actions Envoyer une requête de l’API de l’interface administrateur.

Certains flux de travail devraient peut-être être mis à jour manuellement. Dans ces cas, les flux de travail pourraient afficher une erreur Mise à jour requise ou API non prise en charge et vous guider vers la documentation d’API pertinente pour effectuer les modifications requises dans l’éditeur de flux de travail. Lorsque ces mises à jour sont terminées et enregistrées, le flux de travail se met automatiquement à jour pour utiliser la dernière version d’API disponible dans Flow.

Vous pouvez temporairement ignorer certains problèmes afin d’apporter des modifications urgentes à un flux de travail présentant des erreurs de compatibilité avec la version de l’API. Si ces problèmes ne sont pas résolus, le flux de travail risque de cesser de fonctionner ou de générer des erreurs lorsque l’ancienne version de l’API ne sera plus prise en charge par Shopify.