Method: purchases.subscriptionsv2.scheduleplantransition

Запланируйте переход на другой тарифный план.

HTTP-запрос

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

URL имеет синтаксис gRPC Transcoding.

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

Параметры
packageName

string

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

token

string

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

Тело запроса

Ниже приведена структура данных в теле запроса.

JSON-представление
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
Поля
productId

string

Обязательно. Подписка (например, premium_plan), для которой нужно запланировать переход.

earliestTransitionEffectiveTime

string (Timestamp format)

Обязательно. Самое раннее время, когда переход на другой план может вступить в силу. Фактический переход произойдет в момент продления в указанную дату или после нее.

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

[Обязательный параметр] Режим перехода на другой план. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
definiteTransition

object (DefiniteTransition)

При использовании этого режима переход пользователя на новый план является окончательным и не может быть отменен.

tentativeTransition

object (TentativeTransition)

При использовании этого режима переход пользователя на новый план является предварительным и может быть отменен.

Конец взаимоисключающих полей.
etag

string

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

Тело ответа

Ответ для API purchases.subscriptionsv2.schedulePlanTransition.

Ниже приведена структура данных в ответе, полученном на запрос.

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

object (PlanTransitionDetails)

Сведения о переходе на другой тарифный план для объекта подписки.

Области авторизации

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

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

DefiniteTransition

У этого типа нет полей.

Используется, чтобы указать, что переход на другой тарифный план является окончательным.

TentativeTransition

У этого типа нет полей.

Используется, чтобы указать, что переход на другой тарифный план является предварительным.