Method: purchases.subscriptionsv2.scheduleplantransition

为订阅安排方案切换。

HTTP 请求

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition

网址采用 gRPC 转码语法。

路径参数

参数
packageName

string

必需。之前购买的订阅所对应的应用的软件包(例如“com.some.thing”)。

token

string

必需。在用户购买订阅时向用户设备提供的令牌。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
字段
productId

string

必需。必须安排方案切换的订阅产品(例如“premium_plan”)。

earliestTransitionEffectiveTime

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"。

[必需] 方案切换的模式。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段:
definiteTransition

object (DefiniteTransition)

使用此模式时,用户向新方案的切换是确定的,不能取消。

tentativeTransition

object (TentativeTransition)

使用此模式时,用户向新方案的切换是暂定的,可以取消。

互斥字段结束。
etag

string

如果设置此字段,当 ETag 与相应订阅的最新 ETag 不一致时,API 将失败。ETag 是从 purchases.subscriptionsv2.get 检索到的,详见以下网址:https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

响应正文

针对 purchases.subscriptionsv2.schedulePlanTransition API 的响应。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
字段
planTransitionDetails

object (PlanTransitionDetails)

订阅项的方案切换详情。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/androidpublisher

DefiniteTransition

此类型没有字段。

用于表示方案切换是确定的。

TentativeTransition

此类型没有字段。

用于表示方案切换是暂定的。