- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- DefiniteTransition
- TentativeTransition
- Попробовать
Запланируйте переход на другой тарифный план.
HTTP-запрос
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition
URL имеет синтаксис gRPC Transcoding.
Параметры пути
| Параметры | |
|---|---|
packageName |
Обязательно. Пакет приложения, для которого была приобретена подписка (например, com.some.thing). |
token |
Обязательно. Токен, предоставленный устройству пользователя при покупке подписки. |
Тело запроса
Ниже приведена структура данных в теле запроса.
| 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 ( |
| Поля | |
|---|---|
productId |
Обязательно. Подписка (например, premium_plan), для которой нужно запланировать переход. |
earliestTransitionEffectiveTime |
Обязательно. Самое раннее время, когда переход на другой план может вступить в силу. Фактический переход произойдет в момент продления в указанную дату или после нее. Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
| [Обязательный параметр] Режим перехода на другой план. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей: | |
definiteTransition |
При использовании этого режима переход пользователя на новый план является окончательным и не может быть отменен. |
tentativeTransition |
При использовании этого режима переход пользователя на новый план является предварительным и может быть отменен. |
| Конец взаимоисключающих полей. | |
etag |
Если задано, 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 |
Сведения о переходе на другой тарифный план для объекта подписки. |
Области авторизации
Требуется следующая область действия OAuth:
https://www.googleapis.com/auth/androidpublisher
DefiniteTransition
У этого типа нет полей.
Используется, чтобы указать, что переход на другой тарифный план является окончательным.
TentativeTransition
У этого типа нет полей.
Используется, чтобы указать, что переход на другой тарифный план является предварительным.