Chrome Policy API – Übersicht

Die Chrome Policy API ist eine Suite von Diensten, mit denen Chrome-Administratoren Chrome-Richtlinien programmatisch ansehen und verwalten können, die den Organisationseinheiten in ihrer Organisation zugewiesen sind. Mit dieser API können Chrome-Administratoren Informationen darüber erhalten, wie ChromeOS-Geräte und Chrome-Browser in ihrer Organisation verwendet werden.

Wichtigste Vorteile

  • Kompatibilität mit der Google Admin-Konsole:Änderungen, die Sie über die API vornehmen, werden in der Benutzeroberfläche der Google Admin-Konsole angezeigt und umgekehrt.

  • Audit-Logging:Änderungen, die mit dieser API vorgenommen werden, werden in den standardmäßigen Audit-Logs für die Admin-Konsole protokolliert.

  • Datengesteuerter Ansatz:Chrome-Richtlinien werden als Daten dargestellt. Von der API-Schnittstelle wird nicht direkt darauf verwiesen. So können Sie API-Clients für die Nutzung zukünftiger Chrome-Richtlinien ohne zusätzliche Entwicklung automatisieren. Im Laufe der Zeit wird die Anzahl der über die API unterstützten Richtlinien zunehmen.

  • Ergänzt die Admin SDK API:Diese API ergänzt die Admin SDK API, mit der Chrome-Administratoren die folgenden Aufgaben ausführen können:

In der folgenden Tabelle sind die wichtigsten Aufgaben aufgeführt, die Sie mit dieser API ausführen können. Beispielanfragen und -antworten finden Sie unter Codebeispiele.

URLs beziehen sich auf https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER.

Aufgabenbeschreibung Relative URL HTTP-Methode Anfrageparameter
Richtlinienschemas auflisten ./policySchemas GET Optional: filter, pageSize, pageToken
Richtlinienschema abrufen ./policySchemas/$SCHEMA_NAME GET  
Richtlinien für eine Organisationseinheit oder Gruppe abrufen oder auflisten ./policies:resolve POST Erforderlich: policySchemaFilter, policyTargetKey

Optional: pageSize, pageToken

Richtlinien in einer Organisationseinheit ändern ./policies/orgunits:batchModify POST Erforderlich: requests: {policyTargetKey, policyValue, updateMask}
Richtlinien in einer Organisationseinheit übernehmen ./policies/orgunits:batchInherit POST Erforderlich: requests: {policyTargetKey, policySchema}
Richtlinien in einer Gruppe ändern ./policies/groups:batchModify POST Erforderlich: requests: {policyTargetKey, policyValue, updateMask}
Richtlinien in einer Gruppe löschen ./policies/groups:batchDelete POST Erforderlich: requests: {policyTargetKey, policySchema}
Prioritätsreihenfolgen in einer Gruppe auflisten ./policies/groups:listGroupPriorityOrdering POST Erforderlich: requests: {policyTargetKey, policyNamespace}
Prioritätsreihenfolge in einer Gruppe aktualisieren ./policies/groups:updateGroupPriorityOrdering POST Erforderlich: requests: {policyTargetKey, policyNamespace, groupIds}
Dateien für eine Richtlinie hochladen ./policies/files:uploadPolicyFile POST Erforderlich: requests: {policyField}

Nutzungslimits

Diese API ist nur für die interne Verwendung in der Organisation eines Chrome-Kunden vorgesehen. Weitere Informationen finden Sie in den Nutzungsbedingungen für die Chrome Policy API. Wenn Sie zusammen mit Google einen kommerziellen API-Client erstellen möchten, reichen Sie eine Partnerbewerbung ein.

Nächste Schritte