API для регистрации токенов управления Chrome

API управления токенами регистрации Chrome позволяет администраторам управлять токенами регистрации, используемыми для регистрации браузеров Chrome в Chrome Enterprise Core. Этот набор API можно использовать для создания, получения, отображения и отзыва токенов регистрации для их устройств.

Краткий обзор методов API

URL-адреса являются относительными по отношению к https://chromemanagement.googleapis.com/v1/customers/{customer_id}

Описание Относительный URL HTTP-метод
Создайте токен регистрации. /enrollmentTokens ПОЧТА
Получите токен регистрации /enrollmentTokens/{token_permanent_id} ПОЛУЧАТЬ
Список токенов регистрации /enrollmentTokens ПОЛУЧАТЬ
Отозвать токен регистрации /enrollmentTokens/{token_permanent_id}:revoke ПОЧТА

Примеры запросов и ответов можно посмотреть в примерах кода .

Фильтрация результатов

При выводе списка токенов регистрации с помощью метода /enrollmentTokens можно сузить результаты, используя параметр запроса filter . Все параметры фильтра должны быть экранированы в URL-адресе при отправке в HTTP-запросах. Несколько условий можно комбинировать с помощью оператора AND .

  • Поля типа String и Enum: поддерживаются операторы сравнения = и : .
  • Фильтрация по организационным подразделениям: Вы можете фильтровать токены, созданные для конкретного организационного подразделения, указав org_unit_path или org_unit_id .

Фильтруемые поля

Поле Описание
device_type Тип устройства, для которого используются токены регистрации (в настоящее время CHROME_BROWSER ).
token_state Состояние токена регистрации ( ACTIVE , EXPIRED , REVOKED ).
org_unit_path Путь к организационному подразделению для получения токена регистрации (например /Marketing ).
org_unit_id Организационное подразделение замаскировало идентификатор для токена регистрации.

Административные права

API Chrome Management Enrollment Tokens учитывает делегирование ролей администратора.

Метод Требуются права администратора.
CreateEnrollmentToken «Службы -> Управление Chrome -> Настройки -> Управляемые браузеры»
GetEnrollmentToken «Службы -> Управление Chrome -> Настройки -> Управляемые браузеры»
или "Службы -> Управление Chrome -> Настройки -> Управляемые браузеры -> Читать"
ListEnrollmentTokens «Службы -> Управление Chrome -> Настройки -> Управляемые браузеры»
или "Службы -> Управление Chrome -> Настройки -> Управляемые браузеры -> Читать"
RevokeEnrollmentToken «Службы -> Управление Chrome -> Настройки -> Управляемые браузеры»

Для управления ролями и правами администратора перейдите в раздел «Консоль администратора -> Роли администратора».

Области действия API

API для управления токенами регистрации Chrome требует следующих областей действия OAuth:

Метод Требуются области действия OAuth.
CreateEnrollmentToken https://www.googleapis.com/auth/chrome.management.enrollmenttokens
GetEnrollmentToken https://www.googleapis.com/auth/chrome.management.enrollmenttokens
или https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly
ListEnrollmentTokens https://www.googleapis.com/auth/chrome.management.enrollmenttokens
или https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly
RevokeEnrollmentToken https://www.googleapis.com/auth/chrome.management.enrollmenttokens

Для получения более подробной информации см. раздел «Обзор аутентификации» .