Descripción general de la API de Chrome Policy

La API de Chrome Policy es un conjunto de servicios que permiten a los administradores de Chrome ver y administrar de manera programática las políticas de Chrome asignadas a las unidades organizativas de su organización. Con esta API, los administradores de Chrome pueden obtener estadísticas sobre cómo se usan los dispositivos ChromeOS y los navegadores Chrome en su organización.

Ventajas clave

  • Compatibilidad con la Consola del administrador de Google: Los cambios que realices con la API se reflejarán en la IU de la Consola del administrador de Google y viceversa.

  • Registros de auditoría: Los cambios realizados con esta API se registran en los registros de auditoría del administrador estándar.

  • Enfoque basado en datos: Las políticas de Chrome se representan como datos y la interfaz de la API no hace referencia directamente a ellas. Esto te permitirá automatizar los clientes de API para el consumo de futuras políticas de Chrome sin desarrollo adicional. Con el tiempo, aumentará la cantidad de políticas admitidas a través de la API.

  • Complementa la API del SDK de Admin: Esta API complementa la API del SDK de Admin, en la que los administradores de Chrome pueden realizar las siguientes tareas:

En la siguiente tabla, se enumeran las principales tareas que puedes realizar con esta API. Para revisar las solicitudes y respuestas de ejemplo, ve a Muestras de código.

Las URLs están relacionadas con https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER.

Descripción de la tarea URL relativa Método HTTP parámetros de solicitud
Enumera esquemas de políticas ./policySchemas GET Opcional: filter, pageSize, pageToken
Obtén un esquema de políticas ./policySchemas/$SCHEMA_NAME GET  
Cómo obtener o enumerar políticas para un grupo o una unidad organizativa ./policies:resolve POST Obligatorio: policySchemaFilter, policyTargetKey

Opcional: pageSize, pageToken

Modifica las políticas de una unidad organizativa ./policies/orgunits:batchModify POST Obligatorio: requests: {policyTargetKey, policyValue, updateMask}
Heredar políticas de una unidad organizativa ./policies/orgunits:batchInherit POST Obligatorio: requests: {policyTargetKey, policySchema}
Modifica las políticas de un grupo ./policies/groups:batchModify POST Obligatorio: requests: {policyTargetKey, policyValue, updateMask}
Borra políticas de un grupo ./policies/groups:batchDelete POST Obligatorio: requests: {policyTargetKey, policySchema}
Cómo enumerar los órdenes de prioridad en un grupo ./policies/groups:listGroupPriorityOrdering POST Obligatorio: requests: {policyTargetKey, policyNamespace}
Actualiza los órdenes de prioridad en un grupo ./policies/groups:updateGroupPriorityOrdering POST Obligatorio: requests: {policyTargetKey, policyNamespace, groupIds}
Sube archivos de una política ./policies/files:uploadPolicyFile POST Obligatorio: requests: {policyField}

Límites de uso

Esta API solo se puede usar internamente en la organización de un cliente de Chrome. Para obtener más información, consulta las Condiciones del Servicio de la API de Chrome Policy. Para crear un cliente de API comercial en asociación con Google, envía una solicitud de socio.

Próximos pasos