Method: purchases.subscriptionsv2.defer

延期订阅续订。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
packageName

string

必需。购买的相应订阅所对应的应用的软件包（例如“com.some.thing”）。
token

string

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

请求正文

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

JSON 表示法 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
字段
deferralContext

object (DeferralContext)

必需。有关订阅延期的详细信息。

响应正文

针对 v2 purchases.subscriptions.defer API 的响应。

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

JSON 表示法 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
字段
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

每个订阅商品的新到期时间。

授权范围

需要以下 OAuth 范围：

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

DeferralContext

purchases.subscriptionsv2.defer API 的延期上下文。

JSON 表示法 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
字段
etag

string

必需。如果 ETag 与相应订阅的最新 ETag 不一致，API 将失败。etag 是从 purchases.subscriptionsv2.get 检索到的，详见以下网址：https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get
deferDuration

string (Duration format)

必需。所有订阅商品的延期时长。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。
validateOnly

boolean

如果设置为“true”，则表示相应请求是一次试运行，用于验证 subscriptionsv2.defer 的效果，订阅不会受到影响。

ItemExpiryTimeDetails

订阅商品的到期时间详细信息。

JSON 表示法 
{
  "productId": string,
  "expiryTime": string
}
字段
productId

string

订阅商品的商品 ID（例如“premium_plan”）。
expiryTime

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