为订阅安排方案切换。
HTTP 请求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition
网址采用 gRPC 转码语法。
路径参数
| 参数 | |
|---|---|
packageName |
必需。之前购买的订阅所对应的应用的软件包(例如“com.some.thing”)。 |
token |
必需。在用户购买订阅时向用户设备提供的令牌。 |
请求正文
请求正文中包含结构如下的数据:
| 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 ( |
| 字段 | |
|---|---|
productId |
必需。必须安排方案切换的订阅产品(例如“premium_plan”)。 |
earliestTransitionEffectiveTime |
必需。方案切换可以生效的最早时间。实际切换将在此次续订或之后续订时进行。 采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例: |
| [必需] 方案切换的模式。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段: | |
definiteTransition |
使用此模式时,用户向新方案的切换是确定的,不能取消。 |
tentativeTransition |
使用此模式时,用户向新方案的切换是暂定的,可以取消。 |
| 互斥字段结束。 | |
etag |
如果设置此字段,当 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 |
订阅项的方案切换详情。 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/androidpublisher
DefiniteTransition
此类型没有字段。
用于表示方案切换是确定的。
TentativeTransition
此类型没有字段。
用于表示方案切换是暂定的。