SubscriptionPurchaseV2 中的 latestOrderId 字段已废弃。以下是 SubscriptionPurchaseV2 对象的 JSON 表示法。

JSON 表示法
{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string, Deprecated. Use lineItems.latest_successful_order_id instead.
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  },
  "etag": string,
  "outOfAppPurchaseContext": {
    object (OutOfAppPurchaseContext)
  }
}
字段
kind

string

此类型代表 androidpublisher 服务中的 SubscriptionPurchaseV2 对象。

regionCode

string

授予订阅内容使用权时,用户的 ISO 3166-1 alpha-2 账单邮寄地址所在国家/地区代码。

lineItems[]

object (SubscriptionPurchaseLineItem)

订阅购买交易的商品级信息。同一购买交易中的商品应该全部具有 AutoRenewingPlan 或全部具有 PrepaidPlan。

startTime

string (Timestamp format)

授予订阅内容使用权的时间。请勿针对任何待处理的订阅(订阅已在注册过程中创建,但正在等待付款)设置。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。也支持“Z”以外的偏移量。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

subscriptionState

enum (SubscriptionState)

订阅的当前状态。

latestOrderId
(deprecated)

string

已废弃:请改用 lineItems.latest_successful_order_id。与订阅购买交易关联的最新订单的订单 ID。对于 autoRenewing 订阅,如果尚未续订,这是注册订单的订单 ID;如果已续订,则是最后一个周期性订单 ID(成功、待处理或遭拒订单)。对于 prepaid 订阅,这是与查询的购买令牌相关联的订单 ID。

linkedPurchaseToken

string

当相应订阅属于以下情况之一时,原有订阅的购买令牌:* 重新注册已取消但未失效的订阅 * 从以前的订阅升级/降级。* 从预付费订阅转换为自动续订型订阅。* 从自动续订型订阅转换为预付费订阅。* 为预付费订阅充值。

pausedStateContext

object (PausedStateContext)

有关已暂停订阅的其他背景信息。仅当订阅当前具有如下 subscriptionState 时才存在:SUBSCRIPTION_STATE_PAUSED。

canceledStateContext

object (CanceledStateContext)

有关已取消订阅的其他背景信息。仅当订阅当前具有如下 subscriptionState 时才存在:SUBSCRIPTION_STATE_CANCELED 或 SUBSCRIPTION_STATE_EXPIRED。

testPurchase

object (TestPurchase)

仅当相应订阅购买交易是测试购买交易时才存在。

acknowledgementState

enum (AcknowledgementState)

订阅的确认状态。

externalAccountIdentifiers

object (ExternalAccountIdentifiers)

第三方服务中的用户账号标识符。

subscribeWithGoogleInfo

object (SubscribeWithGoogleInfo)

与利用“通过 Google 订阅”进行的购买交易相关联的用户个人资料。

etag

string

表示订阅当前状态的实体标记。开发者将为订阅操作提供此 etag。对于自动续订型订阅和预付费订阅,此 etag 始终存在。

outOfAppPurchaseContext

object (OutOfAppPurchaseContext)

与应用外购买有关的其他背景信息。仅当通过 Google Play 订阅中心进行重新订阅购买交易(即在同一产品的上一次订阅到期后进行的订阅购买交易)时,此信息才存在。在您确认订阅后,此字段将被移除。