取得訂閱計費嘗試資料

在需有訂閱計費嘗試資料的工作流程中，可以使用「取得訂閱計費嘗試資料」動作來從您的商店擷取訂單資訊。

設定

欄位

「取得訂閱計費嘗試資料」動作包含下列用於建立查詢的欄位：

「取得資料」動作中使用的欄位。

欄位	說明
資料排序依據	必填。對搜尋查詢返回資料進行排序的參數。
結果數量上限	必填。您選取的搜尋查詢可傳回的結果數量上限。一次最多可以傳回 100 筆。
查詢	必填。從一般查詢中選擇，或選取 Advanced (進階) 建立自己的查詢。

查詢字串

以下為查詢範例，旨在取得過去三天建立的訂閱計費嘗試：

created_at:>'{{ createdAt | date_minus: "3 day" }}'

created_at 變數是訂閱計費嘗試查詢中的篩選條件，可用於選取訂閱計費嘗試的特定錯誤訊息。

查詢資料時，瞭解以下資訊會有所助益：

• 可用的訂閱計費嘗試篩選條件清單 - 查詢必須依照特定語法
• 您可以在 QueryRoot 物件的開發人員說明文件中，查看所有查詢的查詢欄位名稱。
• 查詢欄位值不一定都有記錄。在某些情況下，可以查看 API 文件找到這些值。此外，通常您可以在管理介面進行篩選時，於網址中找到欄位值。例如，若要尋找某些訂單查詢值，可以在管理介面中篩選「訂單」頁面，然後檢查網址。
• 您可以使用 Shopify GraphiQL 應用程式在商店中執行或測試查詢。
• 請特別留意，查詢失敗時會發生什麼情況。一般來說，API 將傳回所有結果 (而非未傳回任何結果)。

傳回的資料

所有「取得資料」動作都會傳回一份包含 0 到 100 個資源的清單。依使用案例而定，您可以透過多種方式使用這份資料：

• 如果需要單獨處理每個清單項目，例如為每個清單項目新增標籤，則可以使用 For each (每個) 動作。
• 如果需要彙總資料，例如計算傳回的結果筆數，則可以使用 Count (計數) 或 Sum (總和) 動作。
• 如果需要輸出清單，例如傳送包含所有項目的電子郵件，可以在後續動作直接使用傳回的資料。

若要存取此動作之後的步驟中傳回的資料，請使用名稱為「取得訂閱計費嘗試資料」的變數，即取得訂閱計費嘗試清單。您可以在條件和動作中同時使用此變數。例如，您可以在「傳送內部電子郵件」動作中傳送訂閱計費嘗試清單，如下所示：

{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
  {{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}

備註

若在單一工作流程中多次使用取得資料動作，則會在變數名稱加入一個數字。例如，在兩次使用取得訂單資料動作的工作流程中，傳回資料的第一個變數為 getOrderData 而第二個變數為 getOrderData1。無法自訂這個名稱。

範例

舉例來說，某個工作流程排定在每週日上午 9:00 執行。「取得訂閱計費嘗試資料」動作用於收集上週建立的訂閱計費嘗試資料。如果當中有錯誤訊息，則透過電子郵件傳送計費嘗試。

API 參考

• 訂閱計費嘗試相關資源
• 訂閱計費嘗試查詢篩選條件