Method: subscriptions.changePlan

Обновляет план подписки. Используйте этот метод, чтобы обновить план 30-дневной пробной версии или подписку на гибкий план до годового плана с ежемесячными или ежегодными платежами.

Способ обновления плана зависит от плана и продуктов. Дополнительную информацию см. в описании в разделе «Управление подписками» .

HTTP-запрос

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan

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

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

Параметры
customerId

string

Это может быть либо основное доменное имя клиента, либо уникальный идентификатор клиента. Если доменное имя клиента изменится, старое доменное имя нельзя будет использовать для доступа к клиенту, но всегда можно использовать уникальный идентификатор клиента (возвращаемый API). Мы рекомендуем хранить уникальный идентификатор в ваших системах, где это возможно.

subscriptionId

string

Это обязательное свойство. subscriptionId — это идентификатор подписки, который уникален для каждого клиента. Поскольку subscriptionId меняется при обновлении подписки, мы рекомендуем не использовать этот идентификатор в качестве ключа для постоянных данных. А subscriptionId можно найти с помощью метода получения всех подписок реселлера .

Тело запроса

Тело запроса содержит экземпляр ChangePlanRequest .

Тело ответа

В случае успеха тело ответа содержит экземпляр Subscription .

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

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

  • https://www.googleapis.com/auth/apps.order

Дополнительную информацию см. в руководстве по авторизации .

Запрос на изменение плана

Шаблон JSON для запроса RPC subscribes.changePlan.

JSON-представление
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
Поля
kind

string

Идентифицирует ресурс как запрос на изменение плана подписки. Значение: subscriptions#changePlanRequest

planName

string

Свойство planName является обязательным. Это название плана оплаты подписки. Дополнительную информацию о планах платежей Google см. в разделе Концепции API .

Возможные значения:

  • ANNUAL_MONTHLY_PAY — годовой план обязательств с ежемесячными платежами.
  • ANNUAL_YEARLY_PAY — годовой план обязательств с ежегодными платежами.
  • FLEXIBLE - Гибкий план
  • TRIAL – 30-дневный бесплатный пробный план

seats

object ( Seats )

Это обязательное свойство. Свойство мест — это количество лицензий на места пользователей.

purchaseOrderId

string

Это необязательное свойство. Эта информация о заказе на покупку (PO) предназначена для использования торговыми посредниками для отслеживания использования в их компании. Если указано значение purchaseOrderId , оно появляется в ответах API и отображается в счете. Свойство принимает до 80 символов обычного текста.

dealCode

string

Код, выданный Google (максимум 100 символов), для получения скидки на планы подписки. Чтобы получить скидку, код сделки должен быть включен в запрос changePlan . Это свойство является необязательным. Если код сделки уже добавлен в подписку, это свойство можно оставить пустым, и существующая скидка будет по-прежнему применяться (если не пусто, укажите только код сделки, который уже присутствует в подписке). Если код сделки никогда не добавлялся в подписку и это свойство оставлено пустым, будут применяться обычные цены.