I criteri di Chrome sono rappresentati come schemi dei criteri dall'API Schema Service. Ogni schema dei criteri ha un nome univoco che lo identifica, una definizione dei campi delle impostazioni e i relativi tipi e una descrizione leggibile delle impostazioni in inglese.
Ad esempio, di seguito è illustrato in che modo l'API Schema Service rappresenta un'impostazione che consente di visualizzare un pulsante di disconnessione nella barra delle applicazioni di Chrome. Una rappresentazione semplificata
di questa impostazione sarebbe bool showLogoutButtonInTray
. Fai clic su "Mostra un esempio" di seguito per vedere come l'API Schema Service rappresenta questa impostazione.
Mostra un esempio
{ "name": "customers/C0202nabg/policySchemas/chrome.users.ShowLogoutButton", "policyDescription": "Show logout button in tray.", // description of the policy "definition": { // definition of the settings (fields names and types) "messageType": [ { "name": "ShowLogoutButton", "field": [ { "name": "showLogoutButtonInTray", // the setting showLogoutButtonInTray "number": 1, "label": "LABEL_OPTIONAL", "type": "TYPE_BOOL" // the setting showLogoutButtonInTray is of type boolean } ] } ] }, "fieldDescriptions": [ // human readable descriptions of the settings and their values { "field": "showLogoutButtonInTray", "knownValueDescriptions": [ { "value": "true", "description": "Show logout button in tray." // description for showLogoutButtonInTray=true }, { "value": "false", "description": "Do not show logout button in tray." // description for showLogoutButtonInTray=false } ] } ], "schemaName": "chrome.users.ShowLogoutButton" // unique name to identify the policy }
Nomi degli schemi dei criteri
Il name
di uno schema è il suo identificatore univoco, con il seguente formato:
{namespace}.{leafName}
.
Nell'esempio precedente, il nome completo dello schema è chrome.users.ShowLogoutButton
.
Lo spazio dei nomi è chrome.users.
e il nome foglia è ShowLogoutButton
.
I criteri di ambito simile sono raggruppati nello stesso spazio dei nomi. Ad esempio, tutti
gli schemi dei criteri relativi agli utenti hanno come prefisso uno spazio dei nomi chrome.users.
e tutti
gli schemi dei criteri delle stampanti hanno uno spazio dei nomi chrome.printers.
.
Spazi dei nomi
Spazio dei nomi | Chiave | Autorizzazione ruolo amministratore richiesta |
---|---|---|
chrome.users.LEAF_NAME |
Servizi > Gestione di Chrome > Impostazioni > Gestisci impostazioni utente | |
chrome.users.apps.LEAF_NAME |
key="app_id" |
Servizi > Gestione di Chrome > Impostazioni > Gestisci impostazioni utente > Gestisci impostazioni delle applicazioni |
chrome.users.appsconfig.LEAF_NAME |
Servizi > Gestione di Chrome > Impostazioni > Gestisci impostazioni utente > Gestisci impostazioni delle applicazioni | |
chrome.devices.LEAF_NAME |
Servizi > Gestione di Chrome > Impostazioni > Gestisci le impostazioni dei dispositivi ChromeOS | |
chrome.devices.managedguest.LEAF_NAME |
Servizi > Gestione di Chrome > Impostazioni > Gestisci le impostazioni dei dispositivi ChromeOS | |
chrome.devices.managedguest.apps.LEAF_NAME |
key="app_id" |
Servizi > Gestione di Chrome > Impostazioni > Gestisci le impostazioni dei dispositivi ChromeOS |
chrome.devices.kiosk.LEAF_NAME |
Servizi > Gestione di Chrome > Impostazioni > Gestisci le impostazioni dei dispositivi ChromeOS | |
chrome.devices.kiosk.apps.LEAF_NAME |
key="app_id" |
Servizi > Gestione di Chrome > Impostazioni > Gestisci le impostazioni dei dispositivi ChromeOS |
chrome.devices.kiosk.appsconfig.LEAF_NAME |
Servizi > Gestione di Chrome > Impostazioni > Gestisci le impostazioni dei dispositivi ChromeOS | |
chrome.printers.LEAF_NAME |
key="printer_id" |
Servizi > Gestione di Chrome > Impostazioni > Gestisci stampanti |
chrome.printservers.LEAF_NAME |
key="print_server_id" |
Servizi > Gestione di Chrome > Impostazioni > Gestisci stampanti |
chrome.networks.globalsettings.LEAF_NAME |
Servizi > Impostazioni dispositivi condivisi | |
chrome.networks.wifi.LEAF_NAME |
key="network_id" |
Servizi > Impostazioni dispositivi condivisi |
chrome.networks.ethernet.LEAF_NAME |
key="network_id" |
Servizi > Impostazioni dispositivi condivisi |
chrome.networks.vpn.LEAF_NAME |
key="network_id" |
Servizi > Impostazioni dispositivi condivisi |
chrome.networks.certificates.LEAF_NAME |
key="network_id" |
Servizi > Impostazioni dispositivi condivisi |
Chiavi schema dei criteri
Alcuni criteri richiedono un contesto aggiuntivo per essere visualizzati o modificati. Ad esempio:
- Per modificare il criterio per un'applicazione, devi specificare quale applicazione
compilando
key="app_id"
. - Per modificare il criterio per le impostazioni delle stampanti in un'unità organizzativa, devi
specificare quale stampante compilando
key="printer_id"
.
Questi schemi di criteri contengono una sezione additionalTargetKeyNames
che descrive le chiavi e i valori da passare nelle richieste API.
Per maggiori dettagli, vai a Esempi di codice.
Mostra un esempio
{ "name": "customers/C0202nabg/policySchemas/chrome.printers.AllowForUsers", "policyDescription": "Allows a printer for users in a given organization.", "additionalTargetKeyNames": [ { "key": "printer_id", "keyDescription": "Id of printer as visible in Admin SDK printers API." } ], "definition": { "messageType": [ { "name": "AllowForUsers", "field": [ { "name": "allowForUsers", "number": 1, "label": "LABEL_OPTIONAL", "type": "TYPE_BOOL" } ] } ] }, "fieldDescriptions": [ { "field": "allowForUsers", "description": "Controls whether a printer is allowed for users in a given organization." } ], "schemaName": "chrome.printers.AllowForUsers" }
Criteri delle app
Alcuni degli spazi dei nomi riportati sopra riguardano i criteri relativi alle app, ad esempio le app utente, le app kiosk, le app di sessioni Ospite gestite e i criteri di configurazione delle app kiosk. I criteri delle app richiedono
un app_id
.
Un app_id
viene generato combinando il tipo di app e l'identificatore dell'app. Ad esempio:
chrome:mkaakpdehdafacodkgkpghoibnmamcme
rappresenta l'app di Chrome "Disegni Google"android:com.google.android.calendar
rappresenta l'app per Android "Google Calendar"web:https://canvas.apps.chrome
rappresenta l'app web "Canvas"
Campi con più valori
I campi con l'etichetta LABEL_REPEATED
rappresentano campi con più valori, come elenchi
o array. È possibile assegnare diversi valori a questi campi. Per maggiori dettagli, consulta la sezione Esempi di codice.
Stato schema dei criteri
Ogni criterio ha un oggetto policyApiLifecycle
che rappresenta il suo stato attuale.
Questo oggetto contiene i seguenti campi con dettagli sullo stato del criterio:
- Il campo
policyApiLifecycleStage
mostra quale delle fasi della seguente tabella descrive meglio lo stato attuale del criterio. - Il campo
description
fornisce ulteriori dettagli sullo stato attuale di questo criterio. - Il campo
endSupport
mostra la data finale di supporto per le norme, se ne viene definita una. deprecatedInFavorOf
può essere impostato solo se policyApiLifecycleStage è API_DEPRECATED. Mostra gli spazi dei nomi completi dei nuovi criteri a favore dei quali il criterio attuale è deprecato.- Il campo
scheduledToDeprecatePolicies
corrisponde a deprecatedInFavorOf. Mostra gli spazi dei nomi completi dei vecchi criteri che saranno deprecati a causa dell'introduzione di questo criterio.
Fasi del ciclo di vita
Fase | Descrizione |
---|---|
API_UNSPECIFIED |
Lo stato attuale del criterio è sconosciuto. Riservato, non utilizzarlo. |
API_PREVIEW |
Il criterio non funziona ancora. Questa fase può essere trasferita a API_CURRENT o API_DEVELOPMENT . |
API_DEVELOPMENT |
Le norme non sono ancora state finalizzate e potrebbero essere introdotte modifiche che provocano un errore. Questa fase può essere trasferita a API_CURRENT o API_DEPRECATED . |
API_CURRENT |
Le norme sono in un formato ufficiale, ma potrebbero essere introdotte modifiche sostanziali. Questa fase può essere trasferita a API_DEPRECATED . |
API_DEPRECATED |
Questo criterio è stato ritirato e potrebbe essere rimosso in futuro. Gli amministratori dovrebbero smettere di utilizzare questo criterio. |
Mostra un esempio
{ "name": "customers/C0202nabg/policySchemas/chrome.users.OutdatedPolicy", "policyDescription": "Just for demo, this is an outdated policy.", "definition": { "messageType": [ { "name": "OutdatedPolicy", "field": [ { "name": "outdatedField", "number": 1, "label": "LABEL_OPTIONAL", "type": "TYPE_BOOL" } ] } ] }, "fieldDescriptions": [ { "field": "outdatedField", "description": "This is an outdated field" } ], "schemaName": "chrome.users.OutdatedPolicy", "policyApiLifecycle": { // policy's current lifecycle status "policyApiLifecycleStage": "API_DEPRECATED", "description": "This policy is deprecated. Please stop using it", "endSupport": { "year": 2021, "month": 2, "day": 29 } "deprecatedInFavorOf": "chrome.users.NewPolicy" } } { "name": "customers/C0202nabg/policySchemas/chrome.users.NewPolicy", "policyDescription": "Just for demo, this is a new policy.", "definition": { "messageType": [ { "name": "NewPolicy", "field": [ { "name": "newField", "number": 1, "label": "LABEL_OPTIONAL", "type": "TYPE_BOOL" } ] } ] }, "fieldDescriptions": [ { "field": "newField", "description": "This is an new field" } ], "schemaName": "chrome.users.NewPolicy", "policyApiLifecycle": { // policy's current lifecycle status "policyApiLifecycleStage": "API_CURRENT, "scheduledToDeprecatePolicies": "chrome.users.OutdatedPolicy" } }
Avvisi sullo schema dei criteri
Ad alcuni criteri è associato notices
che ha acknowledgement_required
impostato su true
per determinati valori di determinati campi del criterio. Per questi criteri,
devi impostare un campo di accettazione speciale su true
prima di poter impostare il
valore.
Per maggiori dettagli, consulta la sezione Esempi di codice.
Piattaforme supportate
supportedPlatforms
è un elenco che indica che il criterio verrà applicato soltanto ai dispositivi o agli utenti su queste piattaforme. Tutte le piattaforme supportate sono elencate
nella tabella seguente.
Piattaforma supportata
Piattaforma | Descrizione |
---|---|
PLATFORM_UNSPECIFIED |
Piattaforma non specificata. Riservato, non utilizzarlo. |
CHROME_OS |
ChromeOS |
CHROME_BROWSER |
Browser Chrome per macOS/Windows/Linux |
CHROME_BROWSER_FOR_ANDROID |
Browser Chrome per Android |
CHROME_BROWSER_FOR_IOS |
Browser Chrome per iOS |