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)

与订阅所需的新过期时间相关的信息。

响应正文

对 purchase.subscriptions.defer API 的响应。

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

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

string (int64 format)

订阅的新过期时间（以毫秒为单位，从 Epoch 起算）。

授权范围

需要以下 OAuth 作用域：

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

订阅推迟信息

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

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

string (int64 format)

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

string (int64 format)

分配给订阅的预期后续过期时间（以毫秒为单位，从 Epoch 起算）。指定时间必须晚于/超过订阅的当前过期时间。