REST Resource: subscriptions

{
  "customerId": string,
  "subscriptionId": string,
  "skuId": string,
  "creationTime": string,
  "kind": string,
  "seats": {
    object (Seats)
  },
  "renewalSettings": {
    object (RenewalSettings)
  },
  "purchaseOrderId": string,
  "status": string,
  "resourceUiUrl": string,
  "billingMethod": string,
  "suspensionReasons": [
    string
  ],
  "customerDomain": string,
  "dealCode": string,
  "skuName": string,
  "plan": {
    "planName": string,
    "isCommitmentPlan": boolean,
    "commitmentInterval": {
      "startTime": string,
      "endTime": string
    }
  },
  "trialSettings": {
    "isInTrial": boolean,
    "trialEndTime": string
  },
  "transferInfo": {
    "transferabilityExpirationTime": string,
    "minimumTransferableSeats": integer,
    "currentLegacySkuId": string
  }
}

string

Это свойство всегда будет возвращаться в ответе как уникальный идентификатор, сгенерированный Google. В запросе этим свойством может быть либо основной домен, либо уникальный идентификатор, сгенерированный Google.

string

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

string

Обязательное свойство. skuId — это уникальный системный идентификатор SKU продукта, назначенный клиенту в подписке. Для продуктов и SKU, доступных в этой версии API, см. Идентификаторы продуктов и SKU .

string ( int64 format)

Свойство creationTime — это дата создания подписки. Это значение выражается в миллисекундах в формате Epoch. См. пример конвертера эпох .

string

Идентифицирует ресурс как подписку. Значение: reseller#subscription

object ( Seats )

Это обязательное свойство. Количество и ограничение лицензий на места пользователей в плане.

object ( RenewalSettings )

Настройки продления годового плана обязательств. Более подробную информацию см. в разделе «Параметры продления» в справочном центре администратора .

string

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

string

Это необязательное свойство.

string

URL-адрес страницы подписок клиента в консоли администратора. URL-адрес, доступный только для чтения, создается службой API. Используется, если ваше клиентское приложение требует от клиента выполнения задачи на странице «Подписки» в консоли администратора.

string

Поле, доступное только для чтения, которое возвращает текущий метод выставления счетов за подписку.

string

Поле, доступное только для чтения, содержащее перечисление всех текущих причин приостановки подписки. Подписка может иметь множество одновременных и перекрывающихся причин приостановки. STATUS подписки — SUSPENDED до тех пор, пока все ожидающие приостановки не будут сняты.

Возможные варианты включают в себя:

• PENDING_TOS_ACCEPTANCE – клиент не вошел в систему и не принял Условия использования G Suite Resold.
• RENEWAL_WITH_TYPE_CANCEL — обязательство клиента закончилось, и его обслуживание было отменено по истечении срока действия.
• RESELLER_INITIATED – блокировка вручную, вызванная реселлером.
• TRIAL_ENDED – срок действия пробной версии клиента истек, а план не выбран.
• OTHER – действие клиента заблокировано по внутренней причине Google (например, из-за злоупотреблений или по какой-либо другой причине).

string

Основное доменное имя клиента

string

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

string

Доступное только для чтения внешнее отображаемое имя для SKU продукта, назначенного клиенту в подписке. Названия SKU могут быть изменены по усмотрению Google. Информацию о продуктах и ​​SKU, доступных в этой версии API, см. в разделе «Идентификаторы продуктов и SKU» .

object

Требуется свойство plan . В этой версии API планы G Suite включают гибкий план, годовой план обязательств и 30-дневную бесплатную пробную версию. Дополнительную информацию о планах платежей API см. в разделе «Концепции API» .

string

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

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

• ANNUAL_MONTHLY_PAY — Годовой план обязательств с ежемесячными платежами.
• ANNUAL_YEARLY_PAY — Годовой план обязательств с ежегодными платежами.
• FLEXIBLE — Гибкий план
• TRIAL — 30-дневный бесплатный пробный план. Пробная подписка будет приостановлена ​​после 30-го бесплатного дня, если не будет назначен план оплаты. Вызов changePlan назначит план оплаты пробной версии, но не активирует план. Пробная версия автоматически начнет назначенный план оплаты после 30-го бесплатного дня или сразу после вызова startPaidService .
• FREE . Бесплатный план является эксклюзивным для SKU Cloud Identity и не требует выставления счетов.

boolean

Логическое значение свойства isCommitmentPlan идентифицирует план как годовой план обязательств:

• true — план подписки является годовым планом обязательств.
• false — план не является годовым планом обязательств.

object

В этой версии API интервал годового плана обязательств составляет один год.

string ( int64 format)

startTime интервала годового плана обязательств в миллисекундах в формате UNIX Epoch. См. пример конвертера эпох .

string ( int64 format)

endTime интервала годового плана обязательств в миллисекундах с использованием формата UNIX Epoch. См. пример конвертера эпох .

object

Годовое обязательство G Suite и гибкие планы оплаты могут быть включены в 30-дневную бесплатную пробную версию. Дополнительные сведения см. в разделах «Концепции API» .

boolean

Определяет, включен ли план подписки в 30-дневную бесплатную пробную версию или нет:

• true — план находится на стадии испытания.
• false — план не находится на стадии тестирования.

string ( int64 format)

Дата окончания судебного разбирательства. Значение указывается в миллисекундах в формате эпохи UNIX. См. пример конвертера эпох .

object

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

string ( int64 format)

Время истечения срока действия токена передачи или намерения передачи. Время указывается в миллисекундах в формате UNIX Epoch.

integer

При вставке подписки это минимальное количество мест, указанное в заказе на передачу этого продукта. Например, если у клиента 20 пользователей, торговый посредник не может разместить заказ на передачу 15 рабочих мест. Минимум – 20 мест.

string

skuId текущей перепроданной подписки. Это значение заполняется только в том случае, если у клиента есть подписка с устаревшим номером SKU, а ресурс подписки заполняется skuId SKU, рекомендованным для переноса.

{
  "numberOfSeats": integer,
  "maximumNumberOfSeats": integer,
  "licensedNumberOfSeats": integer,
  "kind": string
}

integer

Это обязательное свойство, доступное только для подписок с планами ANNUAL_MONTHLY_PAY и ANNUAL_YEARLY_PAY . Это свойство устанавливает максимальное количество лицензий, которые можно назначать пользователям по подписке. Реселлер может добавить дополнительные лицензии, но после установки numberOfSeats невозможно уменьшить до продления. Счета-фактуры реселлеру выставляются на основе значения numberOfSeats независимо от того, сколько из этих пользовательских лицензий назначено.

integer

Это обязательное свойство, доступное только для подписок с FLEXIBLE или TRIAL планами. Это свойство устанавливает максимальное количество лицензированных пользователей, разрешенных для подписки. Это количество может быть увеличено до максимального предела, определенного в договоре с реселлером. Минимальное количество — это текущее количество пользователей в учетной записи клиента.

integer

Поле, доступное только для чтения, содержащее текущее количество пользователей, которым назначена лицензия на продукт, определенный в skuId . Значение этого поля эквивалентно числовому количеству пользователей, возвращаемому методом API Enterprise License Manager: listForProductAndSku .

string

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

{
  "renewalType": string,
  "kind": string
}

string

Настройки продления годового плана обязательств. Более подробную информацию см. в разделе «Параметры продления» в справочном центре администратора . При продлении подписки renewalType является обязательным свойством.

string

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