Method: purchases.subscriptions.defer

将用户购买的订阅推迟至指定的未来到期时间。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
packageName

string

购买的相应订阅所对应的应用的软件包名称（例如：“com.some.thing”）。
subscriptionId

string

所购买订阅的 ID（例如“monthly001”）。
token

string

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

请求正文

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

JSON 表示法 
{
  "deferralInfo": {
    object (SubscriptionDeferralInfo)
  }
}
字段
deferralInfo

object (SubscriptionDeferralInfo)

要为相应订阅设置的新到期时间的相关信息。

响应正文

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

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

JSON 表示法 
{
  "newExpiryTimeMillis": string
}
字段
newExpiryTimeMillis

string (int64 format)

相应订阅的新到期时间（以自纪元以来的毫秒数表示）。

授权范围

需要以下 OAuth 范围：

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

SubscriptionDeferralInfo

SubscriptionDeferralInfo 包含将购买的订阅推迟到未来到期时间所需的数据。

JSON 表示法 
{
  "expectedExpiryTimeMillis": string,
  "desiredExpiryTimeMillis": string
}
字段
expectedExpiryTimeMillis

string (int64 format)

订阅的预计到期时间。如果订阅的当前到期时间不是此处指定的值，则不会发生延期。
desiredExpiryTimeMillis

string (int64 format)

要为订阅分配的下一个预期到期时间，以自纪元以来的毫秒数表示。指定的时间必须晚于相应订阅的当前到期时间。