指定された将来の有効期限までユーザーの定期購入を保留します。
HTTP リクエスト
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:defer
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
package |
この定期購入が購入されたアプリのパッケージ名(例: 「com.some.thing」)。 |
subscription |
購入した定期購入の ID(例: 「monthly001」)。 |
token |
定期購入の購入時にユーザーのデバイスに提供されたトークン。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{
"deferralInfo": {
object ( |
フィールド | |
---|---|
deferral |
定期購入の新しい有効期限に関する情報。 |
レスポンスの本文
purchases.subscriptions.defer API のレスポンス
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{ "newExpiryTimeMillis": string } |
フィールド | |
---|---|
new |
定期購入の新しい有効期限(エポックからのミリ秒単位の経過時間)。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/androidpublisher
SubscriptionDeferralInfo
SubscriptionDeferralInfo には、定期購入を将来の有効期限まで延期するのに必要なデータが含まれています。
JSON 表現 |
---|
{ "expectedExpiryTimeMillis": string, "desiredExpiryTimeMillis": string } |
フィールド | |
---|---|
expected |
定期購入の予定有効期限。定期購入に対する現時点の有効期限がここで指定した値と異なる場合、延期は行われません。 |
desired |
定期購入に割り当てる次の有効期限(エポックからのミリ秒単位の経過時間)。指定する時間は、現時点の定期購入の有効期限よりも後に設定する必要があります。 |