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

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