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) 訂閱項目的新到期時間，自 Epoch 紀元時間起算，以毫秒為單位。

範例

以下是要求範例：

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) 要指派給訂閱項目的下一個期滿時間，以 Epoch 紀元時間起算的毫秒數為單位。指定的時間必須晚於/大於訂閱項目目前的到期時間。