Visão geral da API Chrome Policy

A API Chrome Policy é um pacote de serviços que permite que os administradores do Chrome vejam e gerenciem programaticamente as políticas do Chrome atribuídas às unidades organizacionais da organização. Com essa API, os administradores do Chrome têm insights sobre como os dispositivos ChromeOS e os navegadores Chrome estão sendo usados na organização.

Principais vantagens

  • Compatibilidade do Google Admin Console: as alterações feitas com a API são refletidas na IU do Google Admin Console e vice-versa.

  • Registro de auditoria:as alterações feitas com essa API são registradas nos registros de auditoria do administrador padrão.

  • Abordagem baseada em dados:as políticas do Chrome são representadas como dados e não são referenciadas diretamente pela interface da API. Isso permite automatizar clientes de API para o consumo de futuras políticas do Chrome sem precisar de desenvolvimento adicional. Com o tempo, o número de políticas compatíveis com a API aumentará.

  • Complementa a API Admin SDK:essa API complementa a API Admin SDK, em que os administradores do Chrome podem executar as seguintes tarefas:

A tabela abaixo lista as principais tarefas que podem ser concluídas com essa API. Para analisar exemplos de solicitações e respostas, acesse Exemplos de código.

Os URLs são relativos a https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER.

Descrição da tarefa URL relativo Método HTTP Parâmetros de solicitação
Listar esquemas de política ./policySchemas GET Opcional:filter, pageSize e pageToken.
Usar um esquema de política ./policySchemas/$SCHEMA_NAME GET  
Acessar ou listar políticas de uma unidade organizacional ou um grupo ./policies:resolve POST Obrigatório:policySchemaFilter, policyTargetKey

Opcional:pageSize, pageToken

Modificar políticas em uma unidade organizacional ./policies/orgunits:batchModify POST Obrigatório:requests: {policyTargetKey, policyValue, updateMask}
Herdar políticas em uma unidade organizacional ./policies/orgunits:batchInherit POST Obrigatório:requests: {policyTargetKey, policySchema}
Modificar políticas em um grupo ./policies/groups:batchModify POST Obrigatório:requests: {policyTargetKey, policyValue, updateMask}
Excluir políticas em um grupo ./policies/groups:batchDelete POST Obrigatório:requests: {policyTargetKey, policySchema}
Listar ordens de prioridade em um grupo ./policies/groups:listGroupPriorityOrdering POST Obrigatório:requests: {policyTargetKey, policyNamespace}
Atualizar a ordem de prioridade em um grupo ./policies/groups:updateGroupPriorityOrdering POST Obrigatório:requests: {policyTargetKey, policyNamespace, groupIds}
Fazer upload de arquivos para uma política ./policies/files:uploadPolicyFile POST Obrigatório:requests: {policyField}

Limites de uso

Essa API só deve ser usada internamente na organização de um cliente do Chrome. Confira mais detalhes nos Termos de Serviço da API Chrome Policy. Para criar um cliente de API comercial em parceria com o Google, envie uma inscrição para parceiro.

Próximas etapas