取得商品系列資料

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

設定

欄位

「取得商品系列資料」動作包含以下欄位。

查詢字串

以下範例可擷取過去一天內更新的商品系列：

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 single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}

觸發條件

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

API 參考

• 商品系列資源
• 商品系列查詢篩選條件