取得折扣資料
在需要折扣資料的工作流程中,您可以使用 Get discount data 動作,從您的商店擷取折扣資訊。
設定
欄位
Get discount data 動作包含下列欄位,用於建立查詢:
| 欄位 | 說明 |
|---|---|
| 資料排序依據 | 必填。用於排序搜尋查詢所傳回資料的參數。 |
| 最大結果數 | 必填。您選取的搜尋查詢可傳回的結果上限。一次最多可傳回 100 筆。 |
| 查詢 | 必填。可從常用查詢中選擇,或選取 進階 自行建立。 |
查詢字串
以下範例會查詢使用代碼且為啟用中的折扣:
method:code AND status:active變數 method 與 status 是可用於 Discount node query 的篩選器,可重複使用或與其他變數搭配使用。
查詢資料時,下列資訊很有幫助:
- List of available discount filters。
- 查詢必須遵循 特定語法
- 查詢欄位的值未必都有說明文件。有些情況下,您可以在API docs中找到這些值。或者,您也常可在管理介面套用篩選條件時,從網址中找到欄位值。舉例來說,若要找出與訂單相關的查詢值,請在管理介面的「訂單」頁面套用篩選條件,然後查看網址。
- 您可以使用Shopify GraphiQL app在商店中執行或測試查詢。
- 請留意查詢失敗時的行為。API 通常會回傳所有結果 (而非不回傳任何結果)。
回傳的資料
所有取得資料動作都會回傳含有 0 到 100 個資源的清單。依您的使用情境,您可以用不同方式處理這些資料:
- 如果您需要逐一處理清單中的每個項目,例如為每個項目新增標籤,您可以使用For each動作。
- 如果您需要彙總資料,例如計算回傳了多少筆結果,您可以使用Count或Sum動作。
- 如果您需要輸出清單,例如寄送包含所有項目的電子郵件,您即可在後續動作中直接使用回傳的資料。
在此動作後續的步驟中要存取回傳資料時,請使用名為取得折扣資料的變數,該變數為折扣清單。您可以在條件與動作中使用此變數。例如,您可以在寄送內部電子郵件動作中如下寄送自動 app 折扣清單:
{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
* {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}觸發條件
此動作可用於任何工作流程,包括排定時間觸發條件。在使用排定時間觸發條件的工作流程中,系統會在您指定的時間啟動工作流程,而非因事件而啟動。由於不是由商店或 app 的特定事件啟動工作流程,因此不會自動包含任何資料。
API 詳細資訊
範本
每週以電子郵件寄送使用折扣代碼的啟用中折扣摘要
以電子郵件寄送使用折扣代碼的啟用中折扣摘要。此工作流程會按照排程於每週一上午 9 點執行。此工作流程可自訂執行時間、摘要的接收方式、要納入的折扣類型與模式。View template