擷取商品資料

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

設定

欄位

擷取商品資料 動作包含下列欄位，用於建立查詢：

查詢字串

以下是可擷取過去 1 天內更新之商品的查詢範例：

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

updated_at 變數是 Products query 可用的篩選器，可重複使用，或與其他變數組合。使用 Scheduled time trigger 的工作流程提供 scheduledAt Liquid 變數。date_minus Liquid 標籤是 Flow 的特殊標籤，可用來從日期扣除時間。

查詢資料時，以下資訊很實用：

• List of available product filters
• 查詢必須遵循 certain syntax
• 查詢欄位的值未必都有文件說明。有些情況下，您可以參考 API docs 找到這些值。或者，您也經常能在管理介面套用篩選時的 URL 中找到欄位值。舉例來說，若要找出部分訂單查詢的值，請在管理介面的「訂單」頁面套用篩選條件，然後查看網址。
• 您可以使用 Shopify GraphiQL app 在商店中執行或測試查詢。
• 請留意查詢失敗時會發生什麼情況。API 通常會回傳所有結果（而不是不回傳任何結果）。

回傳的資料

所有 擷取資料 動作都會回傳 0 到 100 個資源的清單。視您的使用情境，您可以以下列方式運用這些資料：

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

若要在此動作之後的步驟中存取回傳資料，請使用名為 擷取商品資料 的變數，這是一個商品清單。您可以在條件與動作中使用此變數。例如，您可以在 傳送內部電子郵件 動作中這樣傳送商品清單：

{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}

觸發條件

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

API 詳細資料

• Product resource
• Product query filters

範本

排程將帶有特定標籤的商品加入商品系列

在未來指定時間，擷取所有帶有特定標籤的商品，然後將其加入商品系列。檢視範本

刪除閒置商品

刪除已一年未更新且無庫存的商品。檢視範本

排程發布帶有特定標籤的商品

在未來的某個日期，擷取帶有特定標籤的商品並發布。使用「排程時間」觸發條件與「擷取商品資料」動作。檢視範本

在商品建立後 90 天移除「new」產品標籤

每天最多擷取 100 件在 90 天前建立且仍帶有「new」標籤的商品。接著，工作流程會為每件商品移除該標籤。檢視範本

排程於指定日期與時間，將商品從線上商店移除

在未來的單一日期，依標籤、ID 或存貨單位 (SKU) 將商品從網路商店移除。此流程使用「排程時間」觸發條件、「擷取商品資料」動作與 for each 迴圈。檢視範本

每日寄送含無庫存商品的電子郵件摘要

每天擷取所有庫存為 0 的商品，並寄送電子郵件摘要。使用「擷取商品資料」動作與「排程時間」觸發條件。檢視範本

當新增的子類使用重複的存貨單位 (SKU) 時，寄送通知電子郵件

新增子類時，系統會檢查是否有其他子類使用相同的存貨單位 (SKU)。若有，系統會寄送內部電子郵件，內含受影響商品與子類的連結。檢視範本

使用商品中繼欄位追蹤正在特價的產品子類選項

若某商品至少有一個子類為特價中，則在該商品上設定一個中繼欄位。這可用於追蹤目前正在特價的商品。檢視範本