跳轉到主要內容
若要檢視您帳戶的歷史禮品卡購買與虛擬卡,請使用 getUserPurchases 查詢。此查詢需要 LIST_PURCHASES 範圍。此查詢的回應可能會很龐大,因此我們要求您提供分頁輸入,以及可選的篩選輸入:

擷取購買歷史

您可以使用以下查詢來檢視您的交易。
  1. getUserPurchases — 取得使用者購買紀錄

分頁輸入

OffsetInput 參數用於管理 API 回應的分頁,讓您可以控制每頁要回傳的項目數量,以及從清單開頭要略過多少項目。

欄位

limit (Int):此欄位指定每頁要回傳的項目數量。每頁可要求的最大項目數為 20。若未指定 limit,預設為 20。 offset (Int):此欄位指定在開始回傳項目前要略過的項目數量。若未指定 offset,預設為 0,表示將從清單的第一個項目開始。

篩選輸入

UserPurchaseFilterInput 參數用於篩選回應中回傳的購買紀錄。它允許您擷取與您的應用程式關聯之使用者所做的購買,或與您的應用程式關聯之帳戶下的購買,等等。此參數為可選。若未提供,回應將回傳與您的應用程式關聯之使用者在所有帳戶中的購買。

欄位

scope (Array of PurchaseScopeFilter):此欄位指定要使用的篩選類型。
PurchaseScopeFilter 列舉
  • TOKEN_USER:依據 userId 篩選
  • TOKEN_ACCOUNT:依據 accountId 篩選

範例

回應

當您執行此查詢時,將會回傳一個陣列,包含您歷史的禮品卡購買以及所產生的虛擬卡。

UserPurchase 物件中的欄位