REST Resource: purchases.products

资源：ProductPurchase

ProductPurchase 资源指示用户应用内商品购买的状态。

JSON 表示法 
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
字段
kind

string

此字段表示 androidpublisher 服务中 inappPurchase 对象的类型。
purchaseTimeMillis

string (int64 format)

购买商品的时间，以自纪元（1970 年 1 月 1 日）以来的毫秒数表示。
purchaseState

integer

订单的购买状态。可能的值为：0. 已购买 1. 已取消 2. 待处理
consumptionState

integer

应用内商品的消耗状态。可能的值为：0. 尚未消耗 1. 已使用
developerPayload

string

开发者指定的字符串，其中包含与订单相关的补充信息。
orderId

string

与应用内商品购买交易相关联的订单 ID。
purchaseType

integer

应用内商品的购买类型。仅当相应购买不是按照标准应用内购结算流程完成时，才设置此字段。可能的值为：0. 测试（即从许可测试账号购买）1. 促销（即使用促销代码购买）。不包括 Play 积分购买。2. 奖励（即通过观看视频广告而不是付费获取）
acknowledgementState

integer

应用内商品的确认状态。可能的值为：0. 尚未确认 1. 已确认
purchaseToken

string

为标识相应购买交易而生成的购买令牌。可能不存在。
productId

string

应用内商品的 SKU。可能不存在。
quantity

integer

与应用内商品购买相关的数量。如果不存在，则数量为 1。
obfuscatedExternalAccountId

string

与您的应用中的用户账号唯一关联且经过混淆处理的 ID。仅当购买时使用 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid 指定的情况下才存在。
obfuscatedExternalProfileId

string

与您的应用中的用户个人资料唯一关联且经过混淆处理的 ID。仅当购买时使用 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid 指定的情况下才存在。
regionCode

string

授予商品使用权时用户账单邮寄地址所在地区的代码，采用 ISO 3166-1 alpha-2 格式。
refundableQuantity

integer

符合退款条件的数量，即尚未退款的数量。该值反映基于数量的部分退款和全额退款。

方法

acknowledge

 确认购买应用内商品。

consume

 消耗所购买的应用内商品。

get

 检查应用内商品的购买和消耗状态。

错误代码

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

错误代码 原因 分辨率
5xx Google Play 服务器中的一般错误。 请重试您的请求。

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

尝试更新正在更新的对象。例如，通过同时调用 Play 结算库的 acknowledgePurchase() 方法和 Play Developer API 的 purchases.products.acknowledge 来确认购买交易。

 请重试您的请求。