Ресурс: Подписка
Шаблон JSON для подписки.
Представление JSON |
---|
{ "customerId": string, "subscriptionId": string, "skuId": string, "creationTime": string, "kind": string, "seats": { object ( |
Поля | |
---|---|
customerId | Это свойство всегда будет возвращаться в ответе как уникальный идентификатор, сгенерированный Google. В запросе этим свойством может быть либо основной домен, либо уникальный идентификатор, сгенерированный Google. |
subscriptionId | « |
skuId | Обязательное свойство. |
creationTime | Свойство |
kind | Идентифицирует ресурс как подписку. Значение: |
seats | Это обязательное свойство. Количество и лимит лицензий на рабочие места пользователей в плане. |
renewalSettings | Настройки продления годового плана обязательств. Для получения более подробной информации см. варианты продления в справочном центре администратора . |
purchaseOrderId | Это необязательное свойство. Эта информация о заказе на поставку (PO) предназначена для торговых посредников, чтобы использовать их для отслеживания использования своей компанией. Если указано значение |
status | Это необязательное свойство. |
resourceUiUrl | URL страницы подписок клиента в консоли администратора. URL-адрес только для чтения создается службой API. Это используется, если ваше клиентское приложение требует, чтобы клиент выполнил задачу на странице «Подписки» в консоли администратора. |
billingMethod | Поле только для чтения, которое возвращает текущий метод выставления счетов для подписки. |
suspensionReasons[] | Поле только для чтения, содержащее перечисление всех текущих причин приостановки подписки. Подписка может иметь множество одновременных перекрывающихся причин приостановки.
|
customerDomain | Основное доменное имя клиента |
dealCode | Выданный Google код (максимум 100 символов) для получения скидки на планы подписки. Код сделки должен быть включен в запросы на |
skuName | Доступное только для чтения внешнее отображаемое имя для артикула продукта, назначенного покупателю в подписке. Названия SKU могут быть изменены по усмотрению Google. Информацию о продуктах и артикулах, доступных в этой версии API, см. в разделе Идентификаторы продуктов и артикулов . |
plan | Свойство |
plan.planName | Свойство
|
plan.isCommitmentPlan | Логическое значение свойства
|
plan.commitmentInterval | В этой версии API интервал годового плана обязательств составляет один год. |
plan.commitmentInterval.startTime | |
plan.commitmentInterval.endTime | |
trialSettings | Годовое обязательство G Suite и гибкие планы оплаты могут быть включены в 30-дневную бесплатную пробную версию. Для получения дополнительной информации см. концепции API . |
trialSettings.isInTrial | Определяет, находится ли план подписки в 30-дневной бесплатной пробной версии или нет:
|
trialSettings.trialEndTime | Дата окончания пробного периода. Значение указывается в миллисекундах с использованием формата эпохи UNIX. См. пример конвертера эпох . |
transferInfo | Доступная только для чтения информация о переносе для подписки. Дополнительные сведения см. в разделе получение передаваемых подписок для клиента . |
transferInfo.transferabilityExpirationTime | Время, когда токен передачи или намерение передать истечет. Время указывается в миллисекундах в формате UNIX Epoch. |
transferInfo.minimumTransferableSeats | При вставке подписки это минимальное количество мест, указанное в заказе на перенос для этого продукта. Например, если у клиента 20 пользователей, торговый посредник не может разместить заказ на перенос 15 рабочих мест. Минимум 20 мест. |
transferInfo.currentLegacySkuId | |
Сиденья
Шаблон JSON для мест по подписке.
Представление JSON |
---|
{ "numberOfSeats": integer, "maximumNumberOfSeats": integer, "licensedNumberOfSeats": integer, "kind": string } |
Поля | |
---|---|
numberOfSeats | Это обязательное свойство, эксклюзивное для подписок с |
maximumNumberOfSeats | Это обязательное свойство, доступное только для подписок с планами |
licensedNumberOfSeats | Поле только для чтения, содержащее текущее количество пользователей, которым назначена лицензия на продукт, указанный в |
kind | Идентифицирует ресурс как настройку места подписки. Стоимость: |
Настройки продления
Шаблон JSON для настроек продления подписки.
Представление JSON |
---|
{ "renewalType": string, "kind": string } |
Поля | |
---|---|
renewalType | Настройки продления годового плана обязательств. Для получения более подробной информации см. варианты продления в справочном центре администратора . При продлении подписки |
kind | Идентифицирует ресурс как параметр продления подписки. Значение: |
Методы | |
---|---|
| Активирует подписку, ранее приостановленную реселлером. |
| Обновляет план подписки. |
| Обновляет настройки продления пользовательской лицензии. |
| Обновляет настройки пользовательской лицензии подписки. |
| Отменяет, приостанавливает или переводит подписку в директ. |
| Получает определенную подписку. |
| Создает или передает подписку. |
| Списки подписок, которыми управляет торговый посредник. |
| Немедленно перенесите 30-дневную бесплатную пробную подписку на подписку на платную услугу. |
| Приостанавливает активную подписку. |