Shopify Flow 與 GraphQL Admin API

Flow 使用 Shopify GraphQL Admin API 建立可擴充並強化 Shopify 管理介面的自動化與整合。Flow 使用 API 的 2026-01 版本來評估工作流程中的條件與變數，並在您的 Shopify 商店執行動作。由於 Flow 透過呼叫 API 存取商店資料，您幾乎可以在 Flow 中使用 API 提供的所有欄位。

由於 Shopify 每 3 個月發佈新 API 版本，當欄位變更或被棄用時，部分工作流程可能需要更新。

本頁內容

在工作流程中使用 GraphQL Admin API

Flow 中大多數動作會使用 GraphQL Admin API 來變更您的 Shopify 商店。例如，新增訂單標籤動作會使用 tagsAdd 變異。傳送 Admin API 要求動作可使用多數變異，包括尚未在 Flow 中提供為動作的變異。

在建立工作流程時，您經常會看到以 GraphQL Admin API 語法為基礎的欄位名稱與說明。例如，若要在工作流程中判斷某個子類的可銷售總數量，您會使用 variants_item.inventoryQuantity 變數。另外，例如要判斷顧客是從哪裡訂閱您的電子報，您會使用 emailSubscriptionMethod 變數。

您不需要精通 API 就能使用 Flow app 建立工作流程，但若能稍微瞭解變數名稱及其定義，將有助於您建立所需的特定工作流程邏輯。例如，了解顧客的 displayName 與 firstName 差異，能協助您的工作流程視用途存取正確的資料。在建立工作流程時，每個變數都會附上定義，您可以按一下以瞭解任何變數或定義的更多資訊。

商店資料與 GraphQL Admin API

工作流程會在條件與動作中使用您的商店資料。Flow 使用 GraphQL Admin API 存取商店資料，這表示您幾乎可以使用 API 中的所有欄位。若某個動作未從觸發條件或擷取資料動作取得必要資料，則工作流程不會執行，並會顯示錯誤訊息。

例如，若工作流程以 顧客已建立 觸發條件開始，會將顧客資料匯入工作流程。若該觸發條件之後接著使用 新增訂單標籤 動作，此動作需要的是訂單資料而非顧客資料，則工作流程將發生缺少資料錯誤。

您可能需要先預覽資料，或查閱 API 文件，以瞭解 API 輸出的內容及 Flow 會使用哪些資料，並確保您的工作流程能輸出符合預期的資料。

欄位引數與 GraphQL Admin API

某些 GraphQL Admin API 欄位需要引數，也就是能進一步縮小回傳資料範圍的額外參數。例如，product.inCollection 欄位需要商品系列 id 引數，才能知道要檢查哪個商品系列。如果沒有引數，該欄位就無法回傳結果。

在 Flow 中，您可以藉由提供必要的引數值，從這些欄位建立變數，隨後即可在工作流程中使用該變數。您也可以為變數指派自訂名稱，以便在後續步驟中更輕鬆地參照，例如將 product.inCollection(id: "gid://shopify/Collection/123456") 命名為 product.inSummerBestsellers。

深入瞭解如何從具備引數的欄位建立變數。

在 Flow 中從中繼欄位建立變數需要額外資訊，因為您必須自行定義每個中繼欄位的命名空間和金鑰，因此引數一律是您商店專屬的。深入瞭解 Flow 中的中繼欄位。

API 版本管理

Shopify 每 3 個月都會發佈新的 API 版本，而 Flow 也會儘快採用新版本，但可能仍落後於最新版本。在可行的情況下，版本之間的變更會自動調整，但有些變更可能不那麼單純，包括以下情況：

移除欄位且未提供替代方案時，可能會影響條件或 Liquid 的評估方式。
欄位變為可為空值時，可能會影響條件或 Liquid 的評估方式。
列舉值變更，或新增聯合型別或介面型別時，可能會影響 Liquid 或程式碼。
變異參數變更時，可能會影響「傳送 Admin API 要求」動作的設定。

部分工作流程可能需要手動更新。在這些情況下，工作流程可能會顯示 必須更新 或 不支援的 API 錯誤，並引導您前往相關的 API 文件，在工作流程編輯器中進行必要的變更。完成並儲存這些更新後，工作流程會自動更新為 Flow 可用的最新 API 版本。

若工作流程出現 API 版本相容性錯誤，您可以選擇暫時忽略問題，以便進行緊急變更。若未處理這些問題，當較舊的 API 版本不再受 Shopify 支援時，該工作流程可能會停止執行或發生錯誤。