Schemi dei criteri

I criteri di Chrome sono rappresentati come schemi dei criteri dall'API Schema Service. Ogni schema di criteri ha un nome univoco che lo identifica, una definizione dei campi di impostazione e i relativi tipi, nonché una descrizione leggibile delle impostazioni in inglese.

Ad esempio, di seguito è riportato il modo in cui l'API Schema Service rappresenta un'impostazione che consente la visualizzazione di 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 schemi di criteri

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., mentre il nome della foglia è ShowLogoutButton.

I criteri con ambito simile sono raggruppati nello stesso spazio dei nomi. Ad esempio, tutti gli schemi dei criteri relativi agli utenti sono preceduti da uno spazio dei nomi chrome.users., mentre tutti gli schemi dei criteri della stampante hanno come prefisso uno spazio dei nomi chrome.printers..

Spazi dei nomi

Spazio dei nomi Chiave Autorizzazione del ruolo di amministratore obbligatoria
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 applicazioni
chrome.users.appsconfig.LEAF_NAME   Servizi > Gestione di Chrome > Impostazioni > Gestisci impostazioni utente > Gestisci impostazioni 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 key="app_id" 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 l'applicazione compilando key="app_id".
  • Per modificare il criterio per le impostazioni delle stampanti in un'unità organizzativa, devi specificare la stampante compilando key="printer_id".

Questi schemi di criteri contengono una sezione additionalTargetKeyNames che descrive le chiavi e i valori da trasmettere nelle richieste API.

Per maggiori dettagli, vai ad 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 precedenti riguardano i criteri relativi alle app, ad esempio App utente, App kiosk, App di sessioni Ospite gestite e Configurazione delle app kiosk. I criteri delle app richiedono un app_id.

Un app_id viene creato 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 Android "Google Calendar"
  • web:https://canvas.apps.chrome rappresenta l'app web "Canvas"

Campi multivalore

I campi con l'etichetta LABEL_REPEATED rappresentano campi con più valori, come elenchi o array. Puoi assegnare diversi valori a questi campi. Per maggiori dettagli, consulta la pagina Esempi di codice.

Stato schema dei criteri

Ogni criterio ha un oggetto policyApiLifecycle che ne rappresenta lo 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 del supporto per il criterio, se ne è stata definita una.
  • deprecatedInFavorOf può essere impostato solo se policyApiLifecycleStage è API_DEPRECATED. Mostra gli spazi dei nomi completi dei nuovi criteri per cui il criterio attuale è deprecato.
  • Il campo scheduledToDeprecatePolicies corrisponde a deprecatedInFavorOf. Mostra gli spazi dei nomi completi dei criteri precedenti che verranno deprecati a causa dell'introduzione di questo criterio.

Fasi del ciclo di vita

Palcoscenico Descrizione
API_UNSPECIFIED Lo stato attuale del criterio è sconosciuto. Riservato, non utilizzarlo.
API_PREVIEW Le norme non funzionano ancora. Questa fase può essere trasferita a API_CURRENT o API_DEVELOPMENT.
API_DEVELOPMENT Il criterio non è ancora stato finalizzato 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 significative. Questa fase può essere trasferita a API_DEPRECATED.
API_DEPRECATED Questo criterio è deprecato e potrebbe essere rimosso in futuro. Gli amministratori non dovrebbero più 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 con acknowledgement_required impostato su true per determinati valori di determinati campi dei criteri. Per questi criteri, devi impostare un campo di accettazione speciale su true prima di poter impostare il valore.

Per maggiori dettagli, consulta gli esempi di codice.

Piattaforme supportate

supportedPlatforms è un elenco che indica che il criterio verrà applicato soltanto ai dispositivi o agli utenti di 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

Passaggi successivi