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 Version 2026-01 der API, um Bedingungen und Variablen in Workflows auszuwerten sowie Aktionen in deinem Shopify-Shop auszuführen. Da Flow durch den Aufruf der API auf Shop-Daten zugreift, hast du von Flow aus Zugriff auf fast alle Felder, die in der API verfügbar sind.

Da Shopify alle 3 Monate neue API-Versionen veröffentlicht, müssen einige Workflows möglicherweise aktualisiert werden, wenn Felder geändert oder veraltet sind.

Verwendung der GraphQL Admin API in Workflows

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

Wenn du Workflows erstellst, wirst du häufig auf Feldnamen und Beschreibungen stoßen, die auf der Syntax der GraphQL Admin API basieren. Um beispielsweise die gesamte verkaufsfähige Menge einer Variante in einem Workflow zu bestimmen, verwendest du die Variable variants_item.inventoryQuantity. Um den Standort zu bestimmen, an dem ein:e Kund:in deinen E-Mail-Newsletter abonniert hat, verwendest du die Variable emailSubscriptionMethod.

Du musst die API nicht beherrschen, um Workflows mit der Flow-App zu erstellen, aber ein grundlegendes Verständnis von Variablennamen und ihren Definitionen kann dir helfen, die gewünschte Workflow-Logik zu erstellen. Wenn du beispielsweise den Unterschied zwischen dem displayName und dem firstName eine:r Kund:in kennst, kann dein Workflow auf die richtigen Daten zugreifen, je nachdem, wofür du sie verwenden möchtest. Definitionen sind bei jeder Variable enthalten, während du deinen Workflow erstellst, und du kannst auf klicken, um mehr über eine Variable oder Definition zu erfahren.

Shop-Daten und die GraphQL Admin API

Workflows verwenden Daten aus deinem Shop in Bedingungen und Aktionen. Flow greift über die GraphQL Admin API auf Shop-Daten zu, was bedeutet, dass du auf fast alle Felder in der API Zugriff hast. Wenn eine Aktion nicht über die erforderlichen Daten verfügt, die vom Trigger oder einer Aktion Daten abrufen bereitgestellt werden, wird der Workflow nicht ausgeführt und eine Fehlermeldung wird angezeigt.

Ein Workflow startet beispielsweise mit dem Trigger Kund:in erstellt und importiert Kundendaten in den Workflow. Wenn auf diesen Trigger eine Aktion Bestell-Tags hinzufügen folgt, die Bestelldaten und keine Kundendaten erfordert, führt der Workflow zu einem Fehler wegen fehlender Daten.

Möglicherweise musst du Daten in der Vorschau anzeigen oder die API-Dokumentation überprüfen, um zu verstehen, welche Daten von der API ausgegeben und in Flow verwendet werden, und um sicherzustellen, dass dein Workflow die von dir erwarteten Daten ausgibt.

Feldargumente und GraphQL Admin API

Einige Felder der GraphQL Admin API erfordern Argumente. Dabei handelt es sich um zusätzliche Parameter, die die zurückgegebenen Daten eingrenzen. Das Feld product.inCollection benötigt beispielsweise ein id-Argument für eine Kollektion, um zu wissen, welche Kollektion überprüft werden soll. Ohne dieses Argument kann das Feld kein Ergebnis zurückgeben.

In Flow kannst du Variablen aus diesen Feldern erstellen, indem du den erforderlichen Argumentwert bereitstellst. Diese können dann im Workflow verwendet werden. Du kannst der Variablen auch einen benutzerdefinierten Namen zuweisen, um in nachfolgenden Schritten einfacher darauf verweisen zu können. Du kannst beispielsweise product.inCollection(id: "gid://shopify/Collection/123456") als product.inSummerBestsellers benennen.

Weitere Informationen zur Erstellung von Variablen aus Feldern mit Argumenten.

Die Erstellung von Variablen aus Metafeldern erfordert zusätzliche Informationen in Flow, da du den Namensraum und den Schlüssel jedes Metafelds selbst definierst. Die Argumente sind also immer einzigartig für deinen Shop. Weitere Informationen zu Metafeldern in Flow.

API-Versionierung

Shopify veröffentlicht alle 3 Monate neue API-Versionen und Flow übernimmt neue Versionen so schnell wie möglich, kann aber hinter der neuesten Version zurückbleiben. Wenn möglich, werden Änderungen zwischen den Versionen automatisch übernommen, aber einige Änderungen sind möglicherweise nicht einfach umzusetzen, einschließlich der folgenden Situationen:

• Wenn Felder entfernt werden, aber kein Ersatz bereitgestellt wird, was sich potenziell darauf auswirkt, wie Bedingungen oder Liquid ausgewertet werden.
• Wenn Felder Nullwerte annehmen können, was sich potenziell darauf auswirkt, wie Bedingungen oder Liquid ausgewertet werden.
• Wenn sich Enum-Werte ändern oder neue Union- oder Interface-Typen hinzugefügt werden, was sich potenziell auf Liquid oder Code auswirkt.
• Wenn sich Mutationsargumente ändern, was sich potenziell auf die Konfiguration von Aktionen des Typs „Admin-API-Anfrage senden“ auswirkt.

Einige 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 leiten dich zur relevanten API-Dokumentation, damit du die erforderlichen Änderungen im Workflow-Editor vornehmen kannst. Wenn diese Aktualisierungen abgeschlossen und gespeichert sind, wird der Workflow automatisch aktualisiert, um die neueste in Flow verfügbare API-Version zu verwenden.

Du kannst Probleme vorübergehend ignorieren, um dringende Änderungen an einem Workflow mit Kompatibilitätsfehlern bei der API-Version vorzunehmen. Wenn diese Probleme nicht behoben werden, wird der Workflow möglicherweise nicht mehr ausgeführt oder verursacht Fehler, wenn die ältere API-Version von Shopify nicht mehr unterstützt wird.