Method: purchases.subscriptions.defer

• HTTP 请求
• 路径参数
• 请求正文
  • JSON 表示法
• 响应正文
  • JSON 表示法
• 授权范围
• SubscriptionDeferralInfo
  • JSON 表示法
• 试试看！

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

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