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

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

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

string (int64 format)

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

desiredExpiryTimeMillis

string (int64 format)

分配给订阅的预期下一个过期时间(以毫秒为单位,从 Epoch 起算)。给定时间必须晚于/晚于订阅的当前过期时间。