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)

购买交易达成的时间，以自纪元（1970 年 1 月 1 日）以来的毫秒数表示。
voidedTimeMillis

string (int64 format)

购买交易取消/退款/退单的时间，以自纪元（1970 年 1 月 1 日）以来的毫秒数表示。
orderId

string

用于唯一标识一次性购买、订阅购买或订阅续订的订单 ID。
voidedSource

integer

已作废的购买交易的发起者，可能的值为：0. 用户 1. 开发者 2. Google
voidedReason

integer

购买交易作废的原因，可能的值为：0. 其他 1. 反悔 2. 未收到 3. 有缺陷 4. Accidental_purchase 5. 欺诈 6. 非恶意欺诈 7. 退单 8. Unacknowledged_purchase
voidedQuantity

integer

由于基于数量的部分退款而导致的作废数量。仅当 includeQuantityBasedPartialRefund 设置为 true 时，系统才会返回因基于数量的部分退款而作废的购买交易。

方法

list

 列出已取消、退款或退单的购买交易。

错误代码

此资源的操作会返回以下 HTTP 错误代码：

错误代码 原因 说明 分辨率
400 invalidValue 请求中提供的值无效。如果购买令牌格式有误或无效，系统通常会返回此错误。 根据 API 参考文档，更正请求正文或参数中的无效字段值。
400 required 请求中缺少必需的字段或参数。 请参阅 API 文档，确保包含所有必填字段和参数。
403 userInsufficientPermission 用户没有足够的权限来执行所请求的操作。 确保经过身份验证的用户在 Google Play 管理中心内拥有必要的权限。如需了解详情，请参阅 使用服务账号。
404 notFound 找不到所请求的资源。 验证标识符（例如购买令牌、软件包名称、商品 ID、订阅 ID）是否正确。
409 concurrentUpdate 尝试更新正在并发更新的对象。 使用指数退避算法重试请求。避免同时修改同一资源。
5xx Generic error Google Play 服务器中的一般错误。 请重试您的请求。

如果问题仍然存在，请与您的 Google Play 客户经理联系，或提交支持请求。不妨查看 Play 状态信息中心，了解是否存在任何已知的服务中断。