Method: customers.getSubscriptionInfo

Получает сводную информацию о подписках и лицензиях для данного клиента в виде единственного ресурса. Примечание: поскольку данные для устройств ChromeOS представляют собой моментальный снимок, точные значения могут отображаться с задержкой до 10 секунд.

HTTP-запрос

GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}

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

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

Параметры
name

string

Обязательно. Имя ресурса с информацией о подписке клиента, которую необходимо получить. Формат: customers/{customer}/subscriptionInfo

Текст запроса

Тело запроса должно быть пустым.

Ответный текст

Ресурс-одиночка, представляющий информацию о подписке и лицензии для данного клиента.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
Поля
name

string

Идентификатор. Имя ресурса информации о подписке клиента. Формат: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object ( AnnualSubscriptionInfo )

Только для вывода. Подробная информация о годовом обновлении Chrome Enterprise Upgrade SKU.

kioskSignageUpgradeAnnual

object ( AnnualSubscriptionInfo )

Только вывод. Подробная информация о годовой подписке на обновление киосков и информационных табло.

chromePerpetualUpgrade

object ( PerpetualLicenseInfo )

Только для вывода. Подробная информация о бессрочной подписке на обновление Chrome Ent/Edu.

Области полномочий

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

  • https://www.googleapis.com/auth/chrome.management.subscriptions.readonly

Информация о годовой подписке

Информация для оформления ежегодных подписок/лицензий.

JSON-представление
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
Поля
counts

object ( LicenseCounts )

Только для вывода. Лицензия действует в рамках данной подписки.

subscriptionEndTime

string ( Timestamp format)

Только для вывода. Дата окончания текущего периода подписки.

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

LicenseCounts

Количество ресурсов для конкретного типа лицензии.

JSON-представление
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
Поля
totalPurchasedCount

string ( int64 format)

Только вывод. Общее количество приобретенных лицензий.

assignedCount

string ( int64 format)

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

unassignedCount

string ( int64 format)

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

Информация о бессрочной лицензии

Информация о бессрочных лицензиях.

JSON-представление
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
Поля
counts

object ( LicenseCounts )

Только для вывода. Лицензия распространяется на бессрочный SKU.

retiredCount

string ( int64 format)

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

conditionallyAvailableCount

string ( int64 format)

Только вывод. Количество автономных бессрочных обновлений, которые были ранее зарегистрированы, а затем отменены по причинам возврата товара, гарантии или ремонта, и которые могут быть повторно использованы только на устройстве той же модели. Условно доступные лицензии представляют собой подмножество от общего количества назначенных.