Method: purchases.subscriptionsv2.defer

定期購入の更新を延期します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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)

必須。すべての定期購入アイテムを延期する期間。

s で終わる小数 9 桁までの秒単位の期間。例: "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"