擷取禮品卡資料
在需要禮品卡資料的工作流程中，您可以使用擷取禮品卡資料動作從商店擷取禮品卡資訊。
重要的是，您的商店同時包含用來產生禮品卡的禮品卡商品，以及顧客可用來購物的實際禮品卡本身。擷取禮品卡資料動作會擷取禮品卡本身的資訊。若要取得禮品卡商品的資訊，請使用擷取商品資料或擷取產品子類選項資料動作。
設定
欄位
擷取禮品卡資料動作包含下列欄位，用於建立查詢：
| 欄位 | 說明 |
|---|---|
| 排序依據 | 必填。指定搜尋查詢傳回資料的排序參數。 |
| 結果數上限 | 必填。您選取的搜尋查詢可傳回的結果數上限。每次最多可傳回 100 筆。 |
| 查詢 | 必填。可從常用查詢中選擇，或選取進階自行建立。 |
查詢字串
以下為擷取過去一天內更新的禮品卡的查詢範例：
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'created_at 變數是 禮品卡查詢 可用的篩選條件，可重複使用或與其他變數搭配使用。scheduledAt Liquid 變數適用於使用排程時間觸發條件的工作流程。date_minus Liquid 標籤是 Flow 的特殊標籤，可用來從日期中扣除時間。
查詢資料時，建議先瞭解：
查詢必須遵循 certain syntax
查詢欄位值不一定都有文件記載。有些情況下，您可以在 API docs 中找到這些值。或者，當您在管理介面進行篩選時，通常可以從網址中找到欄位值。舉例來說，若要找出部分訂單查詢值，請在管理介面的「訂單」頁面套用篩選，然後查看網址。
您可以使用 Shopify GraphiQL app 在您的商店中執行或測試查詢。
請留意查詢失敗時會發生的狀況。API 通常會回傳所有結果 (而非沒有任何結果 )。
回傳資料
所有「取得資料」動作都會回傳 0 至 100 個資源的清單。視您的使用情境而定，您可能會以不同方式運用這些資料：
- 如果需要逐一處理清單中的每個項目，例如為每個項目新增標籤，則可使用 For each 動作。
- 如果需要彙整資料，例如計算回傳了多少筆結果，則可使用 Count 或 Sum 動作。
- 如果需要輸出清單，例如寄送包含所有項目的電子郵件，則可在後續動作中直接使用回傳的資料。
若要在此動作後續的步驟中存取回傳的資料，請使用名為「取得禮品卡資料」的變數，它是一份禮品卡清單。您可以在條件與動作中使用此變數。例如，您可以在「寄送內部電子郵件」動作中如下寄送禮品卡清單：
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}觸發條件
此動作可用於任何工作流程，包括「排程時間」觸發條件。在使用「排程時間」觸發條件的工作流程中，工作流程會在您指定的時間開始執行，而非因事件而啟動。由於並沒有來自您的商店或 app 的特定事件啟動工作流程，因此不會自動包含任何資料。