Shopify Flow und GraphQL Admin API

Flow verwendet die Shopify GraphQL Admin API, um Automatisierungen und Integrationen zu erstellen, die den Shopify-Adminbereich erweitern und verbessern. Flow verwendet derzeit die Version 2024-07 der API , um Bedingungen und Variablen in Workflows auszuwerten und Aktionen in deinem Shopify-Shop auszuführen. Da Flow durch das Aufrufen der API auf Shop-Daten zugreift, kannst du über Flow auf nahezu alle in der API verfügbaren Felder zugreifen.

Die meisten Aktionen in Flow verwenden die API, um Änderungen an deinem Shopify-Shop vorzunehmen. Beispielsweise verwendet die Aktion Bestell-Tags hinzufügen die Mutation tagsAdd . Die Aktion Admin API-Anfrage senden kann die meisten Mutationen verwenden, einschließlich derer, die noch nicht als Aktionen in Flow verfügbar sind.

Beim Erstellen von Workflows werden dir oft Feldnamen und Beschreibungen begegnen, die auf der API basieren. Möglicherweise musst du eine Vorschau der Daten anzeigen oder die API-Dokumentation prüfen, um nachzuvollziehen, was von der API ausgegeben und in Flow verwendet wird, und um sicherzustellen, dass dein Workflow die von dir erwarteten Daten ausgibt.

API-Versionsverwaltung

Shopify veröffentlicht alle drei Monate neue API-Versionen. Flow übernimmt die neuen Versionen so bald wie möglich, nutzt aber möglicherweise nicht immer die aktuelle Version. Wenn möglich, werden Änderungen zwischen den Versionen automatisch behoben. Bei manchen Änderungen ist das aber nicht so leicht, darunter bei den folgenden: * Wenn Felder entfernt werden, aber kein Ersatz bereitgestellt wird – dies kann sich auf die Auswertung von Bedingungen oder von Liquid auswirken. * Wenn für Felder der Wert „null“ festgelegt werden kann – dies kann sich auf die Auswertung von Bedingungen oder von Liquid auswirken. * Wenn sich Enumerationswerte ändern oder neue Unions- oder Schnittstellentypen hinzugefügt werden – dies kann sich auf Liquid oder den Code auswirken. * Wenn sich Mutationsargumente ändern – dies kann sich auf die Konfiguration der Aktionen „Admin API-Anfrage senden“ auswirken.

Manche Workflows müssen möglicherweise manuell aktualisiert werden. In diesen Fällen zeigen Workflows möglicherweise den Fehler Aktualisierung erforderlich oder Nicht unterstützte API an und verweisen dich auf die relevante API-Dokumentation, damit du die nötigen Änderungen im Workflow-Editor vornehmen kannst. Wenn diese Aktualisierungen abgeschlossen und gespeichert sind, wird der Workflow automatisch aktualisiert, damit er die neueste API-Version verwendet, die in Flow verfügbar ist.

Du kannst Probleme vorübergehend ignorieren, um dringende Änderungen an einem Workflow vorzunehmen, bei dem ein Fehler bei der API-Versionskompatibilität vorliegt. Wenn diese Probleme nicht behoben werden, wird der Workflow möglicherweise nicht mehr ausgeführt oder es treten Fehler auf, wenn die ältere API-Version von Shopify nicht mehr unterstützt wird.