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)

定期購入の新しい有効期限に関する情報。

レスポンスの本文

Purchase.subscriptions.defer API に対するレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "newExpiryTimeMillis": string
}
フィールド
newExpiryTimeMillis

string (int64 format)

サブスクリプションの新しい有効期限(エポックからのミリ秒数)。

認可スコープ

次の OAuth スコープが必要です。

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

SubscriptionDeferralInfo

SubscriptionDeferralInfo には、定期購入を将来の有効期限まで延期するために必要なデータが含まれています。

JSON 表現
{
  "expectedExpiryTimeMillis": string,
  "desiredExpiryTimeMillis": string
}
フィールド
expectedExpiryTimeMillis

string (int64 format)

サブスクリプションの有効期限。サブスクリプションの現在の有効期限がここで指定した値でない場合、延期は発生しません。

desiredExpiryTimeMillis

string (int64 format)

サブスクリプションに割り当てる次の有効期限(エポックからのミリ秒)。指定する時刻は、サブスクリプションの現在の有効期限よりも後またはそれより長い時間にする必要があります。