API Chrome Management Chrome Browsers

A API Chrome Management Chrome Browsers permite que os administradores visualizem dados e gerenciem navegadores Chrome registrados no Chrome Enterprise Core. Esse conjunto de APIs pode ser usado para listar navegadores Chrome registrados, recuperar um navegador Chrome, atualizar informações de anotação de um navegador Chrome, mover navegadores Chrome entre unidades organizacionais (UOs) e excluir os dados coletados de um navegador Chrome.

Visão geral rápida dos métodos de API

Os URLs são relativos a https://chromemanagement.googleapis.com/v1/customers/{customer_id}

Descrição URL relativo Método HTTP
Listar navegadores Chrome registrados /chromeBrowsers GET
Recuperar um navegador Chrome /chromeBrowsers/{browser_permanent_id} GET
Atualizar as informações de anotação de um navegador Chrome /chromeBrowsers/{browser_permanent_id} PATCH
Mover navegadores Chrome para uma nova unidade organizacional (UO) /chromeBrowsers:move POST
Excluir a coleta de dados de um navegador Chrome /chromeBrowsers/{browser_permanent_id} EXCLUIR

Consulte exemplos de código para exemplos de solicitações e respostas.

Filtrando os resultados

Ao listar navegadores Chrome com o método /chromeBrowsers, é possível restringir os resultados usando o parâmetro de consulta filter. Todos os parâmetros de filtro precisam ser escapados por URL quando enviados em solicitações HTTP. Várias condições podem ser combinadas usando o operador AND.

  • Campos de string, inteiro e tipo enumerado:aceitam os operadores de comparação = e :. O caractere curinga * (prefixo prefix*, sufixo *suffix, substring *substring* ou presença *) é compatível com = e : apenas para machine_name, annotated_asset_id e browser_version (por exemplo, machine_name=LIX* ou browser_version:"*6367*"). A filtragem literal de string global sem adornos (sem um nome de campo) também é compatível: um único termo, como ABC, corresponde se qualquer campo de string indexado contiver ABC, e vários termos unidos por AND ou espaço em branco (por exemplo, machine AND 73 ou machine 73) correspondem a navegadores que contêm todos os termos especificados em qualquer um dos campos de texto indexados (enquanto uma única string de várias palavras entre aspas, como "machine 73", corresponde à frase contígua exata em um único campo).
  • Campos de carimbo de data/hora:aceitam os operadores de comparação =, <= e >=. Os carimbos de data/hora esperam uma string formatada em RFC-3339 entre aspas duplas (por exemplo, "2020-01-01T12:00:00Z" ou "2012-04-21T11:30:00-04:00"). Intervalos de carimbo de data/hora fechados podem ser especificados usando comparações.
  • Filtragem por unidade organizacional:é possível filtrar navegadores que pertencem a uma unidade organizacional específica especificando org_unit_path (por exemplo, org_unit_path=/Marketing). Há suporte para correspondência de uma única unidade organizacional.
  • Filtragem de grupos:é possível filtrar navegadores que pertencem a um grupo específico do Cloud Identity usando a função in_group (por exemplo, in_group("groups/00gjdgxs0lm8l7o")).

Campos que aceitam filtros

Campo Descrição
browser_permanent_id O identificador exclusivo permanente do dispositivo com o navegador Chrome.
last_policy_fetch_time O horário da última busca de política do dispositivo Chrome.
os_platform A plataforma do SO para o dispositivo do navegador Chrome (por exemplo, WINDOWS, MAC, LINUX).
os_architecture A arquitetura do SO do dispositivo com navegador Chrome.
os_version A versão do sistema operacional do dispositivo com navegador Chrome.
machine_name O nome da máquina associada ao dispositivo do navegador Chrome.
annotated_location O local anotado para o dispositivo Chrome.
annotated_user O usuário anotado para o dispositivo Chrome.
annotated_asset_id O código do recurso anotado para o dispositivo Chrome.
annotated_note As observações anotadas do dispositivo Chrome.
org_unit_path O caminho da unidade organizacional para o dispositivo com o navegador Chrome (por exemplo, /Marketing).
org_unit_id O ID da unidade organizacional do dispositivo Chrome.
last_registration_time O horário de registro do dispositivo Chrome.
os_platform_version A plataforma do SO e a versão principal do dispositivo com navegador Chrome.
browser_version Uma versão do navegador Chrome relatada instalada no dispositivo.
last_status_report_time O horário do último relatório de status do dispositivo Chrome.
extension_count O número de extensões instaladas no dispositivo Chrome.
policy_count O número de políticas aplicadas ao dispositivo com o navegador Chrome.
last_device_user O último usuário que fez login na máquina.
last_activity_time A última vez que o dispositivo Chrome mostrou atividade (busca de política ou relatórios).
device_id_collision Se o ID do dispositivo é compartilhado por várias máquinas que o navegador Chrome identifica como a mesma máquina (true ou false).

Filtrar funções

Função Descrição
in_group(string) Filtra a lista de dispositivos do navegador Chrome para aqueles que pertencem ao nome do recurso do grupo do Cloud Identity especificado (formato: in_group("groups/{group_id}")).

Como ordenar resultados

É possível especificar a ordem dos resultados usando o parâmetro de consulta orderBy. Por padrão, a classificação é em ordem crescente. Para especificar a ordem decrescente de um campo, adicione o sufixo " desc" ao nome do campo (por exemplo, last_activity_time desc).

Se não for especificada, a ordem padrão será crescente de browser_permanent_id.

Campos de ordenação compatíveis

  • 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

Privilégios de administrador

A API Chrome Browsers respeita a delegação de funções de administrador.

Método Privilégios de administrador necessários
ListChromeBrowsers "Serviços -> Gerenciamento do Chrome -> Configurações -> Navegadores gerenciados"
ou "Serviços -> Gerenciamento do Chrome -> Configurações -> Navegadores gerenciados -> Ler"
GetChromeBrowser "Serviços -> Gerenciamento do Chrome -> Configurações -> Navegadores gerenciados"
ou "Serviços -> Gerenciamento do Chrome -> Configurações -> Navegadores gerenciados -> Ler"
UpdateChromeBrowser "Serviços -> Gerenciamento do Chrome -> Configurações -> Navegadores gerenciados"
MoveChromeBrowsers "Serviços -> Gerenciamento do Chrome -> Configurações -> Navegadores gerenciados"
DeleteChromeBrowser "Serviços -> Gerenciamento do Chrome -> Configurações -> Navegadores gerenciados"

Para gerenciar as funções e os privilégios de administrador, acesse "Admin Console -> Funções do administrador".

Escopos de API

A API Chrome Management Chrome Browsers requer os seguintes escopos OAuth:

Método Escopos do OAuth necessários
ListChromeBrowsers https://www.googleapis.com/auth/chrome.management.browsers
ou https://www.googleapis.com/auth/chrome.management.browsers.readonly
GetChromeBrowser https://www.googleapis.com/auth/chrome.management.browsers
ou 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 mais informações, consulte a Visão geral da autenticação.