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)

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

示例

以下是一个示例请求：

curl -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "deferralInfo": {
      "desiredExpiryTimeMillis": "1735689600000",
      "expectedExpiryTimeMillis": "1704067200000"
    }
  }' \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly.premium.v1/tokens/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoPqRsTuVwXyZ.1234567890:defer'

以下是示例响应：

{
  "newExpiryTimeMillis": "1776004800000"
}

授权范围

需要以下 OAuth 范围：

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

SubscriptionDeferralInfo

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

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

string (int64 format)

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

string (int64 format)

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