Panoramica dell'API Chrome Policy

L'API Chrome Policy è una suite di servizi che consente agli amministratori di Chrome di visualizzare e gestire in modo programmatico i criteri di Chrome assegnati alle unità organizzative dell'organizzazione. Con questa API, gli amministratori di Chrome possono ottenere informazioni su come i dispositivi ChromeOS e i browser Chrome vengono utilizzati nella loro organizzazione.

Vantaggi principali

  • Compatibilità con la Console di amministrazione Google: le modifiche apportate con l'API sono riflesse nell'interfaccia utente della Console di amministrazione Google e viceversa.

  • Audit logging: le modifiche apportate con questa API vengono registrate negli audit log amministrativi standard.

  • Approccio basato sui dati: i criteri di Chrome sono rappresentati come dati e non sono direttamente indicati dall'interfaccia API. In questo modo puoi automatizzare i client API per l'utilizzo dei criteri di Chrome futuri senza ulteriori sviluppi. Nel tempo, il numero di criteri supportati tramite API aumenterà.

  • Completa l'API SDK Admin:questa API integra l'API Admin SDK, in cui gli amministratori di Chrome possono eseguire le seguenti attività:

La tabella seguente elenca le attività principali che puoi completare con questa API. Per esaminare richieste e risposte di esempio, vai a Esempi di codice.

Gli URL sono relativi a https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER.

Descrizione attività URL relativo Metodo HTTP Parametri richiesta
Elenca schemi di criteri ./policySchemas GET Facoltativo: filter, pageSize, pageToken
Ottieni uno schema dei criteri ./policySchemas/$SCHEMA_NAME GET  
Recuperare o elencare i criteri per un'unità organizzativa o un gruppo ./policies:resolve POST Obbligatori: policySchemaFilter, policyTargetKey

Facoltativo: pageSize, pageToken

Modificare i criteri di un'unità organizzativa ./policies/orgunits:batchModify POST Obbligatorio: requests: {policyTargetKey, policyValue, updateMask}
Ereditare i criteri in un'unità organizzativa ./policies/orgunits:batchInherit POST Obbligatorio: requests: {policyTargetKey, policySchema}
Modificare i criteri in un gruppo ./policies/groups:batchModify POST Obbligatorio: requests: {policyTargetKey, policyValue, updateMask}
Eliminare i criteri in un gruppo ./policies/groups:batchDelete POST Obbligatorio: requests: {policyTargetKey, policySchema}
Elencare gli ordini di priorità in un gruppo ./policies/groups:listGroupPriorityOrdering POST Obbligatorio: requests: {policyTargetKey, policyNamespace}
Aggiornare gli ordini di priorità in un gruppo ./policies/groups:updateGroupPriorityOrdering POST Obbligatorio: requests: {policyTargetKey, policyNamespace, groupIds}
Caricare i file per un criterio ./policies/files:uploadPolicyFile POST Obbligatorio: requests: {policyField}

Limiti di utilizzo

Questa API può essere utilizzata solo internamente all'organizzazione di un cliente Chrome. Per maggiori dettagli, consulta i Termini di servizio dell'API Chrome Policy. Per creare un client API commerciale in collaborazione con Google, invia una richiesta di partecipazione al programma partner.

Passaggi successivi