Chrome Management Chrome Browsers API

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

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

URL относятся к https://chromemanagement.googleapis.com/v1/customers/{customer_id}

Описание Относительный URL Метод HTTP
Как посмотреть список зарегистрированных браузеров Chrome /chromeBrowsers УЗНАВАЙТЕ
Как получить свойства браузера Chrome /chromeBrowsers/{browser_permanent_id} УЗНАВАЙТЕ
Как обновить информацию в примечаниях для браузера Chrome /chromeBrowsers/{browser_permanent_id} PATCH
Переместите браузеры Chrome в новое организационное подразделение /chromeBrowsers:move Опубликовать
Как удалить данные, собранные из браузера Chrome /chromeBrowsers/{browser_permanent_id} УДАЛИТЬ

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

Применение фильтров…

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

  • Поля String, Integer и Enum: поддерживают операторы сравнения = и :. Подстановочный знак * (префикс prefix*, суффикс *suffix, подстрока *substring* или наличие *) поддерживается с операторами = и : только для полей machine_name, annotated_asset_id и browser_version (например, machine_name=LIX* или browser_version:"*6367*"). Также поддерживается фильтрация по глобальному строковому литералу без дополнительных символов (без названия поля): один термин, например ABC, соответствует, если любое индексированное строковое поле содержит ABC, а несколько терминов, соединенных оператором AND или пробелом (например, machine AND 73 или machine 73), соответствуют браузерам, которые содержат каждый указанный термин в любом из своих индексированных текстовых полей (тогда как одна строка из нескольких слов в кавычках, например "machine 73", соответствует точной непрерывной фразе в одном поле).
  • Поля временных меток. Поддерживают операторы сравнения =, <= и >=. Временные метки должны быть указаны в формате RFC-3339 и заключены в двойные кавычки (например, "2020-01-01T12:00:00Z" или "2012-04-21T11:30:00-04:00"). Закрытые диапазоны временных меток можно задавать с помощью сравнений.
  • Фильтрация по организационному подразделению. Вы можете отфильтровать браузеры, принадлежащие определенному организационному подразделению, указав org_unit_path (например, org_unit_path=/Marketing). Поддерживается сопоставление с одним организационным подразделением.
  • Фильтрация по группам. Вы можете отфильтровать браузеры, принадлежащие к определенной группе Cloud Identity, с помощью функции in_group (например, in_group("groups/00gjdgxs0lm8l7o")).

Поля, которые можно фильтровать

Поле Описание
browser_permanent_id Постоянный уникальный идентификатор устройства с браузером Chrome.
last_policy_fetch_time Дата и время последнего извлечения правил на устройстве с браузером Chrome.
os_platform ОС устройства с браузером Chrome, например WINDOWS, MAC, LINUX.
os_architecture Архитектура ОС устройства с браузером Chrome,
os_version Версия ОС устройства с браузером Chrome,
machine_name Имя компьютера, связанного с устройством, на котором установлен браузер Chrome.
annotated_location Указанное администратором местоположение устройства с браузером Chrome.
annotated_user Указанный администратором пользователь устройства с браузером Chrome.
annotated_asset_id Указанный администратором идентификатор объекта устройства с браузером Chrome.
annotated_note Указанные администратором заметки об устройстве с браузером Chrome.
org_unit_path Путь к каталогу организационного подразделения для устройства с браузером Chrome, например /Marketing.
org_unit_id Идентификатор организационного подразделения, к которому относится устройство с браузером Chrome.
last_registration_time Дата и время регистрации устройства с браузером Chrome.
os_platform_version ОС и номер основной версии устройства с браузером Chrome.
browser_version Версия браузера Chrome, установленного на устройстве.
last_status_report_time Дата и время последнего отчета о статусе устройства с браузером Chrome.
extension_count Количество расширений, установленных на устройстве с браузером Chrome.
policy_count Количество правил, примененных к устройству с браузером Chrome.
last_device_user Последний пользователь, выполнивший вход на устройстве.
last_activity_time Дата и время последнего действия на устройстве с браузером Chrome, например извлечение правил или создание отчета.
device_id_collision Используется ли идентификатор устройства несколькими компьютерами, которые браузер Chrome идентифицирует как один и тот же компьютер (true или false).

Фильтровать функции

Функция Описание
in_group(string) Фильтрует список устройств с браузером Chrome, оставляя только те, которые принадлежат к указанному названию ресурса группы Cloud Identity (формат: in_group("groups/{group_id}")).

Сортировка результатов

Вы можете указать порядок результатов с помощью параметра запроса orderBy. По умолчанию сортировка выполняется по возрастанию. Чтобы задать сортировку по убыванию, добавьте к названию поля суффикс " desc" (например, last_activity_time desc).

Если порядок не указан, по умолчанию используется сортировка по возрастанию browser_permanent_id.

Поддерживаемые поля сортировки

  • browser_permanent_id
  • last_policy_fetch_time
  • annotated_user
  • annotated_location
  • annotated_asset_id
  • annotated_notes
  • org_unit_path
  • os_version
  • last_registration_time
  • extension_count
  • policy_count
  • last_device_user
  • machine_name
  • browser_version_channel
  • os_platform_version
  • last_activity_time
  • browser_version

Права администратора

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

Метод Требуются права администратора
ListChromeBrowsers "Сервисы -> Управление Chrome -> Настройки -> Управляемые браузеры"
или "Сервисы -> Управление Chrome -> Настройки -> Управляемые браузеры -> Чтение"
GetChromeBrowser "Сервисы -> Управление Chrome -> Настройки -> Управляемые браузеры"
или "Сервисы -> Управление Chrome -> Настройки -> Управляемые браузеры -> Чтение"
UpdateChromeBrowser "Сервисы -> Управление Chrome -> Настройки -> Управляемые браузеры"
MoveChromeBrowsers "Сервисы -> Управление Chrome -> Настройки -> Управляемые браузеры"
DeleteChromeBrowser "Сервисы -> Управление Chrome -> Настройки -> Управляемые браузеры"

Чтобы управлять ролями и правами администратора, перейдите в раздел "Консоль администратора > Роли администраторов".

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

Для Chrome Management Chrome Browsers API требуются следующие области действия OAuth:

Метод Требуемые области действия OAuth
ListChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
или https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
или https://www.googleapis.com/auth/chrome.management.browsers.readonly
UpdateChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
MoveChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
DeleteChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers

Подробные сведения приведены в разделе Общая информация об аутентификации.