A API Chrome Management Enrollment Tokens permite que os administradores gerenciem tokens de inscrição usados para registrar navegadores Chrome no Chrome Enterprise Core. Esse conjunto de APIs pode ser usado para criar, recuperar, listar e revogar tokens de inscrição dos dispositivos.
Visão geral rápida dos métodos da API
Os URLs são relativos a
https://chromemanagement.googleapis.com/v1/customers/{customer_id}
| Descrição | URL relativo | Método HTTP |
|---|---|---|
| Criar um token de registro | /enrollmentTokens | POST |
| Recuperar um token de registro | /enrollmentTokens/{token_permanent_id} | GET |
| Listar tokens de registro | /enrollmentTokens | GET |
| Revogar um token de registro | /enrollmentTokens/{token_permanent_id}:revoke | POST |
Consulte exemplos de código para solicitações e respostas de exemplo.
Filtrando os resultados
Ao listar tokens de inscrição com o método
/enrollmentTokens, é possível restringir os resultados usando o parâmetro de consulta filter. Todos os parâmetros de filtro precisam ter caracteres de escape de URL quando enviados em solicitações HTTP. Várias condições podem ser combinadas usando o operador AND.
- Campos de string e enumeração:compatíveis com os operadores de comparação
=e:. - Filtragem por unidade organizacional:é possível filtrar tokens criados para uma unidade organizacional específica especificando
org_unit_pathouorg_unit_id.
Campos que aceitam filtros
| Campo | Descrição |
|---|---|
device_type
|
O tipo de dispositivo para que os tokens de registro são usados (atualmente CHROME_BROWSER). |
token_state
|
O estado do token de inscrição (ACTIVE, EXPIRED, REVOKED). |
org_unit_path
|
O caminho da unidade organizacional para o token de inscrição (por exemplo, /Marketing). |
org_unit_id
|
O ID ofuscado da unidade organizacional para o token de registro. |
Privilégios de admin
A API Chrome Management Enrollment Tokens respeita a delegação de função de administrador.
| Método | É necessário ter privilégios de administrador |
|---|---|
| CreateEnrollmentToken | "Serviços -> Gerenciamento do Chrome -> Configurações -> Navegadores gerenciados" |
| GetEnrollmentToken | "Serviços -> Gerenciamento do Chrome -> Configurações ->
Navegadores gerenciados" ou "Serviços -> Gerenciamento do Chrome -> Configurações -> Navegadores gerenciados -> Ler" |
| ListEnrollmentTokens | "Serviços -> Gerenciamento do Chrome -> Configurações ->
Navegadores gerenciados" ou "Serviços -> Gerenciamento do Chrome -> Configurações -> Navegadores gerenciados -> Ler" |
| RevokeEnrollmentToken | "Serviços -> Gerenciamento do Chrome -> Configurações -> Navegadores gerenciados" |
Para gerenciar funções e privilégios de administrador, acesse "Admin Console -> Funções de administrador".
Escopos da API
A API Chrome Management Enrollment Tokens exige os seguintes escopos do OAuth:
| Método | Escopos do OAuth necessários |
|---|---|
| CreateEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
| GetEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens ou https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| ListEnrollmentTokens | https://www.googleapis.com/auth/chrome.management.enrollmenttokens ou https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| RevokeEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
Para mais informações, consulte a Visão geral da autenticação.