Panoramica dell'API Chrome Policy
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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à:
Casi d'uso comuni
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
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eThe Chrome Policy API enables Chrome administrators to programmatically view and manage Chrome policies for their organization's ChromeOS devices and Chrome browsers.\u003c/p\u003e\n"],["\u003cp\u003eIt offers key benefits like Google Admin console compatibility, audit logging, and a data-driven approach for easier automation.\u003c/p\u003e\n"],["\u003cp\u003eAdmins can utilize this API to perform tasks such as listing policy schemas, retrieving specific schemas, and managing policies for organizational units and groups.\u003c/p\u003e\n"],["\u003cp\u003eUsage of this API is restricted to internal use within a Chrome customer's organization, with commercial partnerships requiring a separate application process.\u003c/p\u003e\n"],["\u003cp\u003eFurther exploration is encouraged through provided resources on policy schemas, request setup, and code samples.\u003c/p\u003e\n"]]],[],null,["# Chrome Policy API Overview\n\nThe Chrome Policy API is a suite of services that empower Chrome administrators\nto programmatically view and manage Chrome policies assigned to the\n[Organizational Units](https://support.google.com/a/answer/4352075)\nin their organization. With this API, Chrome admins can gain insights about how\nChromeOS devices and Chrome browsers are being used in their organization.\n\nKey advantages\n--------------\n\n- **Google Admin console compatibility:** Changes you make with the API are\n reflected in Google Admin console UI, and vice versa.\n\n- **Audit logging:** Changes made with this API are logged in the standard\n [Admin Audit logs](https://support.google.com/a/answer/4579579).\n\n- **Data-driven approach:** Chrome policies are represented as data and aren't\n directly referenced by the API interface. This lets you automate API clients\n for consumption of future Chrome policies without additional development. Over\n time, the number of policies supported via API will increase.\n\n- **Complements the Admin SDK API:** This API complements the Admin SDK API,\n where Chrome admins can perform the following tasks:\n\n - [Manage Chrome devices](/admin-sdk/directory/v1/guides/manage-chrome-devices) with the Admin SDK's Directory API.\n - [Manage Chrome browsers](https://support.google.com/chrome/a/answer/9681204) with the Admin SDK's Chrome Browser Management API.\n - [Manage Chrome CUPS printers](/admin-sdk/chrome-printer) with the Admin SDK's Chrome Printer Management API.\n\nPopular use cases\n-----------------\n\nThe table below lists the top tasks you can complete with this API. To review\nexample requests and responses, go to [Code samples](/chrome/policy/guides/samples_policyapi).\n\nURLs are relative to `https://chromepolicy.googleapis.com/v1/customers/`\u003cvar translate=\"no\"\u003e$CUSTOMER\u003c/var\u003e.\n\n| Task description | Relative URL | HTTP method | Request parameters |\n|--------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|-------------|-----------------------------------------------------------------------------------------|\n| [List policy schemas](/chrome/policy/reference/rest/v1/customers.policySchemas/list) | `./policySchemas` | `GET` | *Optional:* `filter`, `pageSize`, `pageToken` |\n| [Get a policy schema](/chrome/policy/reference/rest/v1/customers.policySchemas/get) | `./policySchemas/`\u003cvar translate=\"no\"\u003e$SCHEMA_NAME\u003c/var\u003e | `GET` | |\n| [Get or list policies for an Organizational Unit or Group](/chrome/policy/reference/rest/v1/customers.policies/resolve) | `./policies:resolve` | `POST` | *Required:* `policySchemaFilter`, `policyTargetKey` *Optional:* `pageSize`, `pageToken` |\n| [Modify policies in an Organizational Unit](/chrome/policy/reference/rest/v1/customers.policies.orgunits/batchModify) | `./policies/orgunits:batchModify` | `POST` | *Required:* `requests: {policyTargetKey, policyValue, updateMask}` |\n| [Inherit policies in an Organizational Unit](/chrome/policy/reference/rest/v1/customers.policies.orgunits/batchInherit) | `./policies/orgunits:batchInherit` | `POST` | *Required:* `requests: {policyTargetKey, policySchema}` |\n| [Modify policies in a Group](/chrome/policy/reference/rest/v1/customers.policies.groups/batchModify) | `./policies/groups:batchModify` | `POST` | *Required:* `requests: {policyTargetKey, policyValue, updateMask}` |\n| [Delete policies in a Group](/chrome/policy/reference/rest/v1/customers.policies.groups/batchDelete) | `./policies/groups:batchDelete` | `POST` | *Required:* `requests: {policyTargetKey, policySchema}` |\n| [List priority orderings in a Group](/chrome/policy/reference/rest/v1/customers.policies.groups/listGroupPriorityOrdering) | `./policies/groups:listGroupPriorityOrdering` | `POST` | *Required:* `requests: {policyTargetKey, policyNamespace}` |\n| [Update priority orderings in a Group](/chrome/policy/reference/rest/v1/customers.policies.groups/updateGroupPriorityOrdering) | `./policies/groups:updateGroupPriorityOrdering` | `POST` | *Required:* `requests: {policyTargetKey, policyNamespace, groupIds}` |\n| [Upload files for a policy](/chrome/policy/reference/rest/v1/media/upload) | `./policies/files:uploadPolicyFile` | `POST` | *Required:* `requests: {policyField}` |\n\nUsage limits\n------------\n\nThis API is only for use internally within a Chrome customer's organization. For more details, review the [Chrome Policy API Terms of Service](http://console.cloud.google.com/tos?id=chrome-policy). To build a commercial API client in partnership with Google, submit a [partner application](https://docs.google.com/forms/d/e/1FAIpQLSdJA-2_BZ3FJLSBtuWkPCMPXqUpxGbCta1wXRrrVdUCX7apog/viewform).\n\nNext steps\n----------\n\n- [Learn about policy schemas](./policy-schemas)\n- [Set up and authorize requests](./setup)\n- [Review code samples](./samples)"]]
