Method: purchases.subscriptionsv2.defer

Откладывает продление подписки.

HTTP-запрос

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

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

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

Параметры
packageName

string

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

token

string

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

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

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

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

object ( DeferralContext )

Обязательно. Подробная информация об отсрочке подписки.

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

Ответ для API-запроса v2 purchases.subscriptions.defer.

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

JSON-представление 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
Поля
itemExpiryTimeDetails[]

object ( ItemExpiryTimeDetails )

Новый срок действия для каждого элемента подписки.

Области полномочий

Требуется следующая область действия OAuth:

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

ОтсрочкаКонтекст

Контекст отсрочки API purchases.subscriptionsv2.defer.

JSON-представление 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
Поля
etag

string

Обязательный параметр. API завершится с ошибкой, если etag не совпадает с последним etag для данной подписки. etag извлекается из purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

deferDuration

string ( Duration format)

Обязательно. Укажите срок, на который следует отложить оплату всех подписных товаров.

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивающаяся на « s ». Пример: "3.5s" .

validateOnly

boolean

Если установить значение "true", запрос будет тестовым запуском для проверки эффекта subscriptionsv2.defer, и это никак не повлияет на подписку.

ItemExpiryTimeDetails

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

JSON-представление 
{
  "productId": string,
  "expiryTime": string
}
Поля
productId

string

Идентификатор продукта подписки (например, 'premium_plan').

expiryTime

string ( Timestamp format)

Новый срок действия данной подписки.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .