取得商品子類資料

在使用商品子類資料的工作流程中，您可以使用取得商品子類資料動作，從商店擷取商品子類資訊。

此頁面上

設定

欄位

「取得商品子類資料」動作包含下列用於建立查詢的欄位：

「取得資料」動作中使用的欄位。
欄位	說明
資料排序依據	必填。對搜尋查詢返回資料進行排序的參數。
結果數量上限	必填。您選取的搜尋查詢可傳回的結果數量上限。一次最多可以傳回 100 筆。
查詢	必填。從一般查詢中選擇，或選取 Advanced (進階) 建立自己的查詢。

查詢字串

以下為查詢範例，旨在取得前一天更新的商品子類：

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

updated_at 參數是商品子類查詢中的篩選條件，可重複使用或與其他變數合併使用。scheduledAt Liquid 變數適用於使用「排定時間觸發條件」的工作流程。date_minus Liquid 標籤是特殊 Flow 標籤，可讓您從日期中減去時間。

查詢資料時，瞭解以下資訊會有所助益：

可用的商品子類篩選條件清單 - 查詢必須依照特定語法
查詢欄位值不一定都有記錄。在某些情況下，可以查看 API 文件找到這些值。此外，通常您可以在管理介面進行篩選時，於網址中找到欄位值。例如，若要尋找某些訂單查詢值，可以在管理介面中篩選「訂單」頁面，然後檢查網址。
您可以使用 Shopify GraphiQL 應用程式在商店中執行或測試查詢。
請特別留意，查詢失敗時會發生什麼情況。一般來說，API 將傳回所有結果 (而非未傳回任何結果)。

傳回的資料

所有「取得資料」動作都會傳回一份包含 0 到 100 個資源的清單。依使用案例而定，您可以透過多種方式使用這份資料：

如果需要單獨處理每個清單項目，例如為每個清單項目新增標籤，則可以使用 For each (每個) 動作。
如果需要彙總資料，例如計算傳回的結果筆數，則可以使用 Count (計數) 或 Sum (總和) 動作。
如果需要輸出清單，例如傳送包含所有項目的電子郵件，可以在後續動作直接使用傳回的資料。

若要存取此動作的後續步驟所傳回的資料，請使用名稱為「取得商品子類資料」的變數，即可取得商品子類清單。您可以在條件和動作中同時使用此變數。例如，您可以在「傳送內部電子郵件」動作中傳送訂單清單，如下所示：

{% for single_variant in GetProductVariantData %}
- {{ single_variant.name }}
{% endfor %}

觸發條件

您可以在任何工作流程 (包含排程時間觸發條件) 中使用此動作。在使用排程時間觸發條件的工作流程中，工作流程會在您指定的時間啟動，而非因為事件的結果而啟動。由於您的商店或應用程式沒有啟動工作流程的特定事件，因此系統不會自動包含任何資料。

API 詳細資訊

範本

為新訂單新增免費（100% 折扣）品項

此範本為新訂單添加免費的折扣品項（如果品項有庫存的話）。範本會在不通知顧客的情況下檢查庫存、應用 100% 折扣，並更新訂單。這項自動化處理可有效 (1) 透過為顧客訂單提供驚喜免費品項，加強顧客滿意度；(2) 透過將新或較不知名的商品以免費樣本的形式添加到訂單當中，推廣這些商品；或者 (3) 透過自動化添加免費品項並提供折扣，簡化推廣過程。檢視範本

寄送每週電子郵件摘要以列出庫存不足的子類清單

此工作流程依照排程執行（例如每週一次），執行的工作包括取得庫存不足的商品子類清單、計算結果，以及寄送內含子類名稱與子類管理頁面連結的電子郵件摘要。檢視範本