Method: purchases.subscriptionsv2.defer

延後續訂訂閱項目。

HTTP 要求

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:defer

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
packageName

string

必填。購買這項訂閱方案的應用程式套件 (例如「com.some.thing」)。
token

string

必填。購買訂閱項目時提供給使用者裝置的權杖。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
欄位
deferralContext

object (DeferralContext)

必填。訂閱延期詳細資料。

回應主體

v2 purchases.subscriptions.defer API 的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
欄位
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

每個訂閱項目的新到期時間。

授權範圍

需要下列 OAuth 範圍：

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

DeferralContext

purchases.subscriptionsv2.defer API 的延期背景資訊。

JSON 表示法 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
欄位
etag

string

必填。如果 etag 與這項訂閱項目的最新 etag 不符，API 就會失敗。etag 是從 purchases.subscriptionsv2.get 擷取：https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get
deferDuration

string (Duration format)

必填。所有訂閱項目應延期的時間長度。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。
validateOnly

boolean

如果設為「true」，表示要求是試營運，用於驗證 subscriptionsv2.defer 的影響，訂閱項目不會受到影響。

ItemExpiryTimeDetails

訂閱項目的到期時間詳細資料。

JSON 表示法 
{
  "productId": string,
  "expiryTime": string
}
欄位
productId

string

訂閱項目的產品 ID (例如「premium_plan」)。
expiryTime

string (Timestamp format)

這項訂閱項目的新到期時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。