Method: purchases.subscriptions.defer

Устарело: используйте purchases.subscriptionsv2.defer вместо этого. Откладывает покупку подписки пользователем до указанного будущего времени истечения срока действия.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
packageName

string

Название пакета приложения, для которого была приобретена эта подписка (например, 'com.some.thing').

subscriptionId

string

Идентификатор приобретенной подписки (например, 'monthly001').

token

string

Токен, предоставленный устройству пользователя при покупке подписки.

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "deferralInfo": {
    object (SubscriptionDeferralInfo)
  }
}
Поля
deferralInfo

object ( SubscriptionDeferralInfo )

Информация о новом желаемом сроке истечения подписки.

Ответный текст

Ответ на запрос API purchases.subscriptions.defer.

В случае успеха тело ответа будет содержать данные следующей структуры:

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)

Желаемое время следующего истечения срока действия подписки в миллисекундах с начала эпохи. Указанное время должно быть позже/больше текущего времени истечения срока действия подписки.