API de Chrome Management Chrome Browsers

La API de Chrome Browsers de la administración de Chrome permite que los administradores vean datos y administren los navegadores Chrome inscritos en Chrome Enterprise Core. Este conjunto de APIs se puede usar para enumerar los navegadores Chrome inscritos, recuperar un navegador Chrome, actualizar la información de anotación de un navegador Chrome, mover navegadores Chrome entre unidades organizativas (UO) y borrar los datos recopilados de un navegador Chrome.

Descripción general rápida de los métodos de la API

Las URLs son relativas a https://chromemanagement.googleapis.com/v1/customers/{customer_id}

Descripción URL relativa Método HTTP
Enumera los navegadores Chrome inscritos /chromeBrowsers GET
Recupera un navegador Chrome /chromeBrowsers/{browser_permanent_id} GET
Actualiza la información de anotación de un navegador Chrome /chromeBrowsers/{browser_permanent_id} PATCH
Mueve los navegadores Chrome a una nueva unidad organizativa (UO) /chromeBrowsers:move PUBLICAR
Cómo borrar los datos recopilados de un navegador Chrome /chromeBrowsers/{browser_permanent_id} BORRAR

Consulta las muestras de código para ver ejemplos de solicitudes y respuestas.

Filtrando resultados

Cuando enumeras los navegadores Chrome con el método /chromeBrowsers, puedes limitar los resultados con el parámetro de consulta filter. Todos los parámetros de filtro deben tener escape de URL cuando se envían en solicitudes HTTP. Se pueden combinar varias condiciones con el operador AND.

  • Campos de cadena, número entero y enumeración: Admiten los operadores de comparación = y :. El comodín * (prefijo prefix*, sufijo *suffix, substring *substring* o presencia *) es compatible con = y : solo para machine_name, annotated_asset_id y browser_version (por ejemplo, machine_name=LIX* o browser_version:"*6367*"). También se admite el filtrado de literales de cadena global sin adornos (sin un nombre de campo): un solo término como ABC coincide si algún campo de cadena indexado contiene ABC, y varios términos unidos por AND o espacios en blanco (por ejemplo, machine AND 73 o machine 73) coinciden con los navegadores que contienen cada término especificado en cualquiera de sus campos de texto indexados (mientras que una sola cadena de varias palabras entre comillas, como "machine 73", coincide con la frase contigua exacta dentro de un solo campo).
  • Campos de marca de tiempo: Admiten los operadores de comparación =, <= y >=. Las marcas de tiempo esperan una cadena con formato RFC-3339 entre comillas dobles (por ejemplo, "2020-01-01T12:00:00Z" o "2012-04-21T11:30:00-04:00"). Los rangos de marcas de tiempo cerrados se pueden especificar con comparaciones.
  • Filtrado por unidad organizativa: Puedes filtrar los navegadores que pertenecen a una unidad organizativa específica si indicas org_unit_path (por ejemplo, org_unit_path=/Marketing). Se admite la coincidencia con una sola unidad organizativa.
  • Filtrado de grupos: Puedes filtrar los navegadores que pertenecen a un grupo específico de Cloud Identity con la función in_group (por ejemplo, in_group("groups/00gjdgxs0lm8l7o")).

Campos filtrables

Campo Descripción
browser_permanent_id Es el identificador único permanente del dispositivo con navegador Chrome.
last_policy_fetch_time La hora de la última recuperación de políticas del dispositivo con navegador Chrome
os_platform Es la plataforma del SO para el dispositivo con navegador Chrome (p.ej., WINDOWS, MAC, LINUX).
os_architecture La arquitectura del SO del dispositivo con navegador Chrome
os_version La versión del SO del dispositivo con navegador Chrome
machine_name Es el nombre de la máquina asociada con el dispositivo con navegador Chrome.
annotated_location La ubicación anotada para el dispositivo con navegador Chrome.
annotated_user Es el usuario anotado para el dispositivo con navegador Chrome.
annotated_asset_id Es el ID del activo anotado para el dispositivo con navegador Chrome.
annotated_note Son las notas anotadas para el dispositivo con navegador Chrome.
org_unit_path Es la ruta de acceso de la unidad organizativa del dispositivo con navegador Chrome (p.ej., /Marketing).
org_unit_id Es el ID de la unidad organizativa del dispositivo con navegador Chrome.
last_registration_time La hora de registro del dispositivo con navegador Chrome.
os_platform_version La plataforma del SO y la versión principal para el dispositivo con navegador Chrome.
browser_version Es una versión informada del navegador Chrome que se instaló en el dispositivo.
last_status_report_time La hora del último informe de estado del dispositivo con navegador Chrome.
extension_count Es la cantidad de extensiones instaladas en el dispositivo con el navegador Chrome.
policy_count Es la cantidad de políticas que se aplican al dispositivo con navegador Chrome.
last_device_user El último usuario que accedió a la máquina.
last_activity_time La última vez que el dispositivo con navegador Chrome mostró actividad (recuperación de políticas o informes)
device_id_collision Indica si varias máquinas que el navegador Chrome identifica como la misma máquina comparten el ID de dispositivo (true o false).

Filtrar funciones

Función Descripción
in_group(string) Filtra la lista de dispositivos con el navegador Chrome para mostrar los que pertenecen al nombre del recurso del grupo de Cloud Identity especificado (formato: in_group("groups/{group_id}")).

Ordena resultados

Puedes especificar el orden de los resultados con el parámetro de consulta orderBy. De forma predeterminada, la ordenación se realiza en orden ascendente. Para especificar el orden descendente de un campo, agrega el sufijo " desc" al nombre del campo (por ejemplo, last_activity_time desc).

Si no se especifica, el orden predeterminado es ascendente de browser_permanent_id.

Campos de ordenamiento admitidos

  • 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

Privilegios de administrador

La API de Chrome Browsers respeta la delegación de roles de administrador.

Método Se requieren privilegios de administrador
ListChromeBrowsers "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados"
o "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados -> Leer"
GetChromeBrowser "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados"
o "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados -> Leer"
UpdateChromeBrowser "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados"
MoveChromeBrowsers "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados"
DeleteChromeBrowser "Servicios -> Administración de Chrome -> Configuración -> Navegadores administrados"

Para administrar los roles y privilegios de administrador, visita "Consola del administrador -> Roles de administrador".

Permisos de la API

La API de Chrome Browsers de la administración de Chrome requiere los siguientes permisos de OAuth:

Método Permisos de OAuth requeridos
ListChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
o https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
o 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

Para obtener más información, consulta la Descripción general de la autenticación.