Présentation de l'API Chrome Policy

L'API Chrome Policy est une suite de services qui permet aux administrateurs Chrome d'afficher et de gérer de manière automatisée les règles Chrome attribuées aux unités organisationnelles de leur organisation. Cette API permet aux administrateurs Chrome d'obtenir des informations sur l'utilisation des appareils ChromeOS et des navigateurs Chrome dans leur organisation.

Principaux avantages

  • Compatibilité avec la console d'administration Google:les modifications que vous apportez avec l'API sont répercutées dans l'interface utilisateur de la console d'administration Google, et inversement.

  • Journaux d'audit:les modifications apportées avec cette API sont consignées dans les journaux d'audit d'administration standards.

  • Approche basée sur les données:les règles Chrome sont représentées par des données et ne sont pas directement référencées par l'interface API. Cela vous permet d'automatiser la consommation des futures règles Chrome par les clients API, sans développement supplémentaire. Au fil du temps, le nombre de règles compatibles avec l'API augmentera.

  • Complète l'API du SDK Admin:cette API complète l'API du SDK Admin, qui permet aux administrateurs Chrome d'effectuer les tâches suivantes:

Le tableau ci-dessous liste les principales tâches que vous pouvez effectuer avec cette API. Pour consulter des exemples de requêtes et de réponses, consultez Exemples de code.

Les URL sont relatives à https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER.

Description de la tâche URL relative Méthode HTTP Paramètres de requête
Répertorier les schémas de règle ./policySchemas GET Facultatif:filter, pageSize, pageToken
Obtenir un schéma de règle ./policySchemas/$SCHEMA_NAME GET  
Obtenir ou répertorier des règles pour une unité organisationnelle ou un groupe ./policies:resolve POST Obligatoire:policySchemaFilter, policyTargetKey

Facultatifs:pageSize, pageToken

Modifier les règles d'une unité organisationnelle ./policies/orgunits:batchModify POST Obligatoire: requests: {policyTargetKey, policyValue, updateMask}
Hériter des règles d'une unité organisationnelle ./policies/orgunits:batchInherit POST Obligatoire: requests: {policyTargetKey, policySchema}
Modifier les règles d'un groupe ./policies/groups:batchModify POST Obligatoire: requests: {policyTargetKey, policyValue, updateMask}
Supprimer des règles dans un groupe ./policies/groups:batchDelete POST Obligatoire: requests: {policyTargetKey, policySchema}
Répertorier l'ordre de priorité d'un groupe ./policies/groups:listGroupPriorityOrdering POST Obligatoire: requests: {policyTargetKey, policyNamespace}
Mettre à jour l'ordre de priorité d'un groupe ./policies/groups:updateGroupPriorityOrdering POST Obligatoire: requests: {policyTargetKey, policyNamespace, groupIds}
Importer des fichiers pour une règle ./policies/files:uploadPolicyFile POST Obligatoire: requests: {policyField}

Limites d'utilisation

Cette API est réservée à une utilisation interne au sein de l'organisation d'un client Chrome. Pour en savoir plus, consultez les Conditions d'utilisation de l'API Chrome Policy. Pour créer un client API commercial en partenariat avec Google, envoyez une demande de partenariat.

Étapes suivantes