取得折扣資料

在需要折扣資料的工作流程中,您可以使用 Get discount data 動作,從您的商店擷取折扣資訊。

設定

欄位

Get discount data 動作包含下列欄位,用於建立查詢:

Get data 動作中使用的欄位。
欄位說明
資料排序依據必填。用於排序搜尋查詢所傳回資料的參數。
最大結果數必填。您選取的搜尋查詢可傳回的結果上限。一次最多可傳回 100 筆。
查詢必填。可從常用查詢中選擇,或選取 進階 自行建立。

查詢字串

以下範例會查詢使用代碼且為啟用中的折扣:

method:code AND status:active

變數 methodstatus 是可用於 Discount node query 的篩選器,可重複使用或與其他變數搭配使用。

查詢資料時,下列資訊很有幫助:

  • List of available discount filters
  • 查詢必須遵循 特定語法
  • 查詢欄位的值未必都有說明文件。有些情況下,您可以在API docs中找到這些值。或者,您也常可在管理介面套用篩選條件時,從網址中找到欄位值。舉例來說,若要找出與訂單相關的查詢值,請在管理介面的「訂單」頁面套用篩選條件,然後查看網址。
  • 您可以使用Shopify GraphiQL app在商店中執行或測試查詢。
  • 請留意查詢失敗時的行為。API 通常會回傳所有結果 (而非不回傳任何結果)。

回傳的資料

所有取得資料動作都會回傳含有 0 到 100 個資源的清單。依您的使用情境,您可以用不同方式處理這些資料:

  • 如果您需要逐一處理清單中的每個項目,例如為每個項目新增標籤,您可以使用For each動作。
  • 如果您需要彙總資料,例如計算回傳了多少筆結果,您可以使用CountSum動作。
  • 如果您需要輸出清單,例如寄送包含所有項目的電子郵件,您即可在後續動作中直接使用回傳的資料。

在此動作後續的步驟中要存取回傳資料時,請使用名為取得折扣資料的變數,該變數為折扣清單。您可以在條件與動作中使用此變數。例如,您可以在寄送內部電子郵件動作中如下寄送自動 app 折扣清單:

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

觸發條件

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

API 詳細資訊

範本

每週以電子郵件寄送使用折扣代碼的啟用中折扣摘要

以電子郵件寄送使用折扣代碼的啟用中折扣摘要。此工作流程會按照排程於每週一上午 9 點執行。此工作流程可自訂執行時間、摘要的接收方式、要納入的折扣類型與模式。View template