取得商品資料
在使用顧客資料的工作流程中,您可以使用取得顧客資料動作來從商店中檢索顧客資訊。
設定
欄位
「取得商品資料」動作包含下列用於建立查詢的欄位:
欄位 | 說明 |
---|---|
資料排序依據 | 必填。對搜尋查詢返回資料進行排序的參數。 |
結果數量上限 | 必填。您選取的搜尋查詢可傳回的結果數量上限。一次最多可以傳回 100 筆。 |
查詢 | 必填。從一般查詢中選擇,或選取 Advanced (進階) 建立自己的查詢。 |
查詢字串
以下為查詢範例,旨在取得前一天更新的商品資料:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'
updated_at
參數是商品查詢中的篩選條件,可重複使用或與其他變數合併使用。scheduledAt
Liquid 變數適用於使用「排定時間」(Scheduled time) 觸發條件的工作流程。date_minus
Liquid 標籤是特殊 Flow 標籤,可讓您從日期中減去時間。
查詢資料時,瞭解以下資訊會有所助益:
- 可用的商品篩選條件清單 - 查詢必須依照特定語法
- 查詢欄位值不一定都有記錄。在某些情況下,可以查看 API 文件找到這些值。此外,通常您可以在管理介面進行篩選時,於網址中找到欄位值。例如,若要尋找某些訂單查詢值,可以在管理介面中篩選「訂單」頁面,然後檢查網址。
- 您可以使用 Shopify GraphiQL 應用程式在商店中執行或測試查詢。
- 請特別留意,查詢失敗時會發生什麼情況。一般來說,API 將傳回所有結果 (而非未傳回任何結果)。
傳回的資料
所有「取得資料」動作都會傳回一份包含 0 到 100 個資源的清單。依使用案例而定,您可以透過多種方式使用這份資料:
- 如果需要單獨處理每個清單項目,例如為每個清單項目新增標籤,則可以使用 For each (每個) 動作。
- 如果需要彙總資料,例如計算傳回的結果筆數,則可以使用 Count (計數) 或 Sum (總和) 動作。
- 如果需要輸出清單,例如傳送包含所有項目的電子郵件,可以在後續動作直接使用傳回的資料。
若要存取此動作之後的步驟中傳回的資料,請使用名稱為「取得商品資料」的變數,即取得商品清單。您可以在條件和動作中同時使用此變數。例如,您可以在「傳送內部電子郵件」動作中傳送商品清單,如下所示:
{% for single_product in GetProductData %}
- {{ single_product.name }}
{% endfor %}
觸發條件
您可以在任何工作流程 (包含排程時間觸發條件) 中使用此動作。在使用排程時間觸發條件的工作流程中,工作流程會在您指定的時間啟動,而非因為事件的結果而啟動。由於您的商店或應用程式沒有啟動工作流程的特定事件,因此系統不會自動包含任何資料。
API 詳細資訊
範本
日後將具有標籤的商品加到商品系列
在未來的特定時間取得具有特定標籤的所有商品,然後將這些商品加到商品系列。檢視範本
刪除已停用的商品
刪除一年內未更新的無庫存商品。檢視範本
在日後發布具有特定標籤的商品
在未來某日取得具有特定標籤的商品並予以發布。使用「排程時間」(Scheduled time) 觸發條件和「取得商品資料」(Get product data) 動作。檢視範本
在商品建立後 90 天刪除新商品標籤
每天取得最多 100 個 90 天前建立且仍有「新」標籤的商品。然後,工作流程會為每個商品移除這些標籤。檢視範本
安排在指定日期和時間從網路商店中移除商品
根據標籤、ID 或存貨單位 (SKU),在未來某日將商品從網路商店中移除。使用「排程時間」(Scheduled time) 觸發條件、「取得商品資料」(Get Product Data) 動作,以及「針對每項」(For Each) 迴圈。檢視範本
寄送每日電子郵件摘要以列出無庫存的商品
每天取得所有庫存為零的商品並寄送電子郵件摘要。使用取得商品資料和排程時間觸發條件。檢視範本
新增 SKU 重複的子類時寄送電子郵件通知
新增子類時,檢查是否有其他子類使用相同的存貨單位 (SKU)。如有,則會寄送內部電子郵件以提供受影響商品和子類的連結。檢視範本
使用商品中繼欄位,追蹤特價產品子類選項
如果商品至少一個子類正在以特價形式銷售,設定商品中繼欄位。此範本可有效追蹤哪個商品目前正在以特價形式銷售。檢視範本