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)

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