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)

新訂閱項目的預期到期時間相關資訊。

回應主體

如果成功,回應主體即會包含具有以下結構的資料:

購買.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 紀元時間起算)。指定的時間必須晚於目前訂閱的到期時間。