說明
登入

取得訂單草稿資料

在使用訂單草稿資料的工作流程中，您可以使用 取得訂單草稿資料 動作，從您的商店擷取訂單草稿資訊。

本頁內容

設定

欄位

「取得訂單草稿資料」動作包含下列欄位，用於建立查詢：

用於「取得資料」動作的欄位。
欄位說明
排序依據必填。用於排序搜尋查詢所傳回資料的參數。
結果數上限必填。您選擇的搜尋查詢可傳回的結果數上限。每次最多可傳回 100 筆。
查詢必填。可從常用查詢中選擇，或選取 進階 自行建立查詢。

查詢字串

以下範例查詢會取得最近一天內更新的訂單草稿：

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

updated_at 變數是可用於 訂單草稿查詢 的篩選器，您可以重複使用或與其他變數搭配。使用 排程時間觸發條件 的工作流程可使用 scheduledAt Liquid 變數。date_minus Liquid 標籤是 Shopify Flow 的特殊標籤，可用來從日期減去時間。

查詢資料時，下列資訊會很有幫助：

  • 可用的訂單篩選器清單
  • 查詢必須遵循 特定語法
  • 查詢欄位的值不一定都有文件說明。有些情況下，您可以在 API 文件 中找到這些值。或者，您也常常能在管理介面篩選時的網址中找到欄位值。例如，想要找到部分訂單查詢的值時，請在管理介面的「訂單」頁面套用篩選後，檢查網址。
  • 您可以使用 Shopify GraphiQL app 在您的商店執行或測試查詢。
  • 請留意查詢失敗時會發生什麼事。API 通常會傳回所有結果 (而非不傳回任何結果)。

傳回的資料

所有 取得資料 動作都會傳回 0 到 100 個資源的清單。依您的使用情境不同，您可能會以不同方式使用這些資料：

  • 如果需要逐一處理清單項目，例如為每個項目新增標籤，您可以使用 逐一 動作。
  • 如果需要彙整資料，例如計算傳回了多少筆結果，您可以使用 計數 或 加總 動作。
  • 如果需要輸出清單，例如寄送包含所有項目的電子郵件，您可以在後續動作中直接使用傳回的資料。

若要在此動作後續的步驟中存取傳回資料，請使用名為 取得訂單草稿資料 的變數，該變數是一份訂單草稿清單。您可以在條件與動作中使用此變數。例如，您可以在 寄送內部電子郵件 動作中這樣傳送訂單草稿清單：

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

觸發條件

您可以在任何工作流程中使用此動作，包括 排程時間 觸發條件。在使用 排程時間 觸發條件的工作流程中，工作流程會在您指定的時間開始，而不是因事件而啟動。由於沒有來自您的商店或任何 app 的特定事件來啟動工作流程，因此不會自動包含任何資料。

API 詳細資訊

範本

每日傳送所有開啟的訂單草稿通知

每日取得開啟的訂單草稿、計數，並傳送 Slack 訊息。使用「排程時間」觸發條件、「取得訂單草稿」與「計數」動作。檢視範本