REST Resource: purchases.voidedpurchases

資源：VoidedPurchase

VoidedPurchase 資源表示已取消/退款/退單的購買交易。

JSON 表示法 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
欄位
kind

string

這類代表 androidpublisher 服務中已取消的購買交易物件。
purchaseToken

string

專門用來識別一次性購買交易或訂閱項目的權杖。如要識別不重複的續訂交易，請使用 orderId (API 第 3 版起提供)。
purchaseTimeMillis

string (int64 format)

購買時間，以自 Epoch 紀元時間 (1970 年 1 月 1 日) 起的毫秒為單位。
voidedTimeMillis

string (int64 format)

取消/退款/退刷交易的時間，以自 Epoch 紀元時間 (1970 年 1 月 1 日) 起的毫秒為單位。
orderId

string

訂單 ID，用於專門識別一次性消費、訂閱交易或續訂。
voidedSource

integer

作廢交易的發起者，可能的值為：0。使用者 1。開發人員 2。Google
voidedReason

integer

交易作廢的原因，可能的值包括：0. 其他 1. 後悔 2. Not_received 3. 有瑕疵 4. Accidental_purchase 5. 詐欺 6. Friendly_fraud 7. 交易退單 8. Unacknowledged_purchase
voidedQuantity

integer

依數量提供部分退款後，取消的數量。只有在 includeQuantityBasedPartialRefund 設為 true 時，依數量提供部分退款的交易才能退回。

方法

list

 列出已取消、退款或退單的購買交易。

錯誤代碼

這項資源的作業會傳回下列 HTTP 錯誤碼：

錯誤代碼 原因 說明 解析度
400 invalidValue 要求中提供的值無效。如果購買權杖格式有誤或無效，通常會傳回這個錯誤。 根據 API 參考資料，更正要求主體或參數中的無效欄位值。
400 required 要求缺少必要欄位或參數。 請參閱 API 說明文件，確認已包含所有必填欄位和參數。
403 userInsufficientPermission 使用者沒有足夠的權限可執行要求作業。 確認已驗證的使用者在 Google Play 管理中心具備必要權限。詳情請參閱「 使用服務帳戶」。
404 notFound 找不到要求的資源。 確認 ID (例如購買憑證、套件名稱、產品 ID、訂閱 ID) 正確無誤。
409 concurrentUpdate 嘗試更新正在同步更新的物件。 以指數輪詢方式重試要求。請避免同時修改相同資源。
5xx Generic error Google Play 伺服器發生一般錯誤。 請重試要求。

如果問題持續發生，請與 Google Play 帳戶管理員聯絡，或提交支援要求。建議查看 Play 狀態資訊主頁，瞭解是否有已知服務中斷情形。