Method: purchases.subscriptions.defer

指定された将来の有効期限までユーザーの定期購入を保留します。

HTTP リクエスト

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

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

パスパラメータ

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

定期購入に割り当てる次の有効期限（エポックからのミリ秒単位の経過時間）。指定する時間は、現時点の定期購入の有効期限よりも後に設定する必要があります。