Schemi dei criteri

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 di impostazione campi e i relativi tipi, nonché una descrizione leggibile delle impostazioni in Inglese.

Ad esempio, l'API Schema Service rappresenta un'impostazione che consente la visualizzazione di un pulsante di disconnessione nella barra delle applicazioni di Chrome. Un modello di questa impostazione sarebbe bool showLogoutButtonInTray. Clic "Mostra un esempio" di seguito per vedere come l'API Schema Service rappresenta dell'ambientazione.

{
  "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, nel formato seguente: {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

Chiavi schema dei criteri

Alcuni criteri richiedono un contesto aggiuntivo per essere visualizzati o modificati. Ad esempio:

• Per modificare il criterio di un'applicazione, devi specificare quale applicazione compilando key="app_id".
• Per modificare i criteri per le impostazioni delle stampanti in un'unità organizzativa, è necessario: specifica 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.

{
  "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 le norme relative alle app, ad esempio App utente, App kiosk, Criteri relativi alle app per le sessioni Ospite gestite e alla configurazione delle app kiosk. I criteri delle app richiedono app_id.

Un app_id viene generato combinando il tipo di app e l'identificatore dell'app. Ad esempio:

• chrome:mkaakpdehdafacodkgkpghoibnmamcme rappresenta "Disegni Google" App di Chrome
• android:com.google.android.calendar rappresenta "Google Calendar" App per Android
• web:https://canvas.apps.chrome rappresenta la "Tela" App web

Campi con più valori

I campi con l'etichetta LABEL_REPEATED rappresentano campi con più valori, come gli elenchi o array. È possibile assegnare diversi valori a questi campi. Per ulteriori dettagli, consulta 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 sul criterio stato:

• Il campo policyApiLifecycleStage mostra quale fase della procedura che descrive meglio lo stato attuale del criterio.
• Il campo description fornisce ulteriori dettagli sullo stato attuale di questo criterio.
• Il campo endSupport mostra l'ultima data di supporto per le norme, se presente viene definito.
• È possibile impostare deprecatedInFavorOf solo se policyApiLifecycleStage è API_DEPRECATED. Mostra gli spazi dei nomi completi dei nuovi criteri. a favore del criterio attuale deprecato.
• Il campo scheduledToDeprecatePolicies corrisponde a deprecatoInFavorOf. Mostra gli spazi dei nomi completi del vecchio che verranno ritirati a causa dell'introduzione di questo criterio.

Fasi del ciclo di vita

{
  "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

Alcuni criteri hanno notices associati con acknowledgement_required impostato su true per determinati valori di determinati campi del criterio. Per questi criteri, devi impostare un campo di conferma 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 per i dispositivi o gli utenti su queste piattaforme. Tutte le piattaforme supportate sono elencate in la tabella seguente.

Piattaforma supportata

Passaggi successivi

• Abilitare l'API Chrome Policy e autorizzare le richieste
• Elencare gli schemi dei criteri con l'API