擷取產品子類選項資料
在使用產品子類選項資料的工作流程中，您可以使用「擷取產品子類選項資料」動作，從商店擷取產品子類選項資訊。
設定
欄位
「擷取產品子類選項資料」動作包含下列欄位，用於建立查詢：
| 欄位 | 說明 |
|---|---|
| 資料排序依據 | 必填。決定搜尋查詢所傳回資料排序方式的參數。 |
| 最大結果數量 | 必填。您所選搜尋查詢可傳回的最大結果數量。每次最多可傳回 100 筆。 |
| 查詢 | 必填。可從常見查詢中選擇，或選取 進階 自行建立。 |
查詢字串
以下為取得過去 1 天內更新之產品子類選項的查詢範例：
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'變數 updated_at 是 產品子類選項查詢 可用的篩選條件，可重複使用或與其他變數搭配。scheduledAt 為 Liquid 變數，適用於使用 排程時間觸發條件 的工作流程。date_minus 為 Liquid 標籤，是 Flow 的特殊標籤，可用於從日期中扣除時間。
查詢資料時，瞭解以下資訊會很有幫助：
- 可用的產品子類選項篩選條件清單
- 查詢必須遵循 特定語法
- 查詢欄位的值並非總有文件記載。有些情況下，您可以在 API 文件 中找到這些值。或者，您常可在管理介面套用篩選時的網址中找到欄位值。例如，若要找出部分訂單查詢的值，請在管理介面的「訂單」頁面套用篩選，然後檢視網址。
- 您可以使用 Shopify GraphiQL app 在商店中執行或測試查詢。
- 請留意查詢失敗時會發生什麼情況。API 通常會傳回所有結果 (而非沒有任何結果)。
傳回的資料
所有「擷取資料」動作都會傳回包含 0 到 100 個資源的清單。依您的使用情境，您可能會以各種方式使用這些資料：
- 若需要逐一處理清單項目，例如為每個項目新增標籤，您可以使用 for each 迴圈 動作。
- 若需要彙總資料，例如計算傳回了多少結果，您可以使用 計數 或 加總 動作。
- 若需要輸出清單，例如寄送包含所有項目的電子郵件，您可以在後續動作中直接使用傳回的資料。
若要在此動作後續的步驟中存取傳回的資料，請使用名為 擷取產品子類選項資料 的變數，這是一個產品子類選項清單。您可以在條件與動作中使用此變數。例如，您可以在 寄送內部電子郵件 動作中，以下列方式傳送訂單清單：
{% for single_variant in GetProductVariantData %}
* {{ single_variant.name }}
{% endfor %}觸發條件
您可在任何工作流程中使用此動作，包含 排程時間 觸發條件。使用 排程時間 觸發條件時，系統會在您指定的時間啟動流程，而非因事件啟動。由於不是由您的商店或 app 的特定事件啟動，系統不會自動包含任何資料。
API 詳情
範本
將免費 (折扣 100%) 品項加入新訂單
此範本會在品項有庫存時，將免費 (折扣 100%) 品項加入新訂單。系統會檢查庫存、套用 100% 折扣，並在不通知顧客的情況下更新訂單。此自動化可用於： (1) 在訂單中加入驚喜免費品項以提升顧客滿意度，(2) 在訂單中加入免費試用品以推廣新商品或較不知名的商品，或 (3) 透過自動加入並折抵免費品項來簡化促銷活動。檢視範本
每週寄送含低庫存子類清單的電子郵件摘要
此工作流程會依排程執行 (例如每週一次)。系統會擷取低庫存的產品子類選項清單、計算結果數量，並寄送電子郵件摘要，其中包含子類名稱與該子類在管理介面的頁面連結。檢視範本