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

Идентификатор приобретенной подписки (например, «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 содержит данные, необходимые для отсрочки покупки подписки на определенный срок в будущем.

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

string ( int64 format)

Ожидаемое время истечения срока действия подписки. Если текущее время истечения срока действия подписки не равно указанному здесь значению, отсрочка не произойдет.

desiredExpiryTimeMillis

string ( int64 format)

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