REST Resource: enterprises.policies

Risorsa: criterio

Una risorsa criterio rappresenta un gruppo di impostazioni che regolano il comportamento di un dispositivo gestito e delle app installate.

Rappresentazione JSON
{
  "name": string,
  "version": string,
  "applications": [
    {
      object (ApplicationPolicy)
    }
  ],
  "maximumTimeToLock": string,
  "screenCaptureDisabled": boolean,
  "cameraDisabled": boolean,
  "keyguardDisabledFeatures": [
    enum (KeyguardDisabledFeature)
  ],
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "persistentPreferredActivities": [
    {
      object (PersistentPreferredActivity)
    }
  ],
  "openNetworkConfiguration": {
    object
  },
  "systemUpdate": {
    object (SystemUpdate)
  },
  "accountTypesWithManagementDisabled": [
    string
  ],
  "addUserDisabled": boolean,
  "adjustVolumeDisabled": boolean,
  "factoryResetDisabled": boolean,
  "installAppsDisabled": boolean,
  "mountPhysicalMediaDisabled": boolean,
  "modifyAccountsDisabled": boolean,
  "safeBootDisabled": boolean,
  "uninstallAppsDisabled": boolean,
  "statusBarDisabled": boolean,
  "keyguardDisabled": boolean,
  "minimumApiLevel": integer,
  "statusReportingSettings": {
    object (StatusReportingSettings)
  },
  "bluetoothContactSharingDisabled": boolean,
  "shortSupportMessage": {
    object (UserFacingMessage)
  },
  "longSupportMessage": {
    object (UserFacingMessage)
  },
  "passwordRequirements": {
    object (PasswordRequirements)
  },
  "wifiConfigsLockdownEnabled": boolean,
  "bluetoothConfigDisabled": boolean,
  "cellBroadcastsConfigDisabled": boolean,
  "credentialsConfigDisabled": boolean,
  "mobileNetworksConfigDisabled": boolean,
  "tetheringConfigDisabled": boolean,
  "vpnConfigDisabled": boolean,
  "wifiConfigDisabled": boolean,
  "createWindowsDisabled": boolean,
  "networkResetDisabled": boolean,
  "outgoingBeamDisabled": boolean,
  "outgoingCallsDisabled": boolean,
  "removeUserDisabled": boolean,
  "shareLocationDisabled": boolean,
  "smsDisabled": boolean,
  "unmuteMicrophoneDisabled": boolean,
  "usbFileTransferDisabled": boolean,
  "ensureVerifyAppsEnabled": boolean,
  "permittedInputMethods": {
    object (PackageNameList)
  },
  "stayOnPluggedModes": [
    enum (BatteryPluggedMode)
  ],
  "recommendedGlobalProxy": {
    object (ProxyInfo)
  },
  "setUserIconDisabled": boolean,
  "setWallpaperDisabled": boolean,
  "choosePrivateKeyRules": [
    {
      object (ChoosePrivateKeyRule)
    }
  ],
  "alwaysOnVpnPackage": {
    object (AlwaysOnVpnPackage)
  },
  "frpAdminEmails": [
    string
  ],
  "deviceOwnerLockScreenInfo": {
    object (UserFacingMessage)
  },
  "dataRoamingDisabled": boolean,
  "locationMode": enum (LocationMode),
  "networkEscapeHatchEnabled": boolean,
  "bluetoothDisabled": boolean,
  "complianceRules": [
    {
      object (ComplianceRule)
    }
  ],
  "blockApplicationsEnabled": boolean,
  "installUnknownSourcesAllowed": boolean,
  "debuggingFeaturesAllowed": boolean,
  "funDisabled": boolean,
  "autoTimeRequired": boolean,
  "permittedAccessibilityServices": {
    object (PackageNameList)
  },
  "appAutoUpdatePolicy": enum (AppAutoUpdatePolicy),
  "kioskCustomLauncherEnabled": boolean,
  "androidDevicePolicyTracks": [
    enum (AppTrack)
  ],
  "skipFirstUseHintsEnabled": boolean,
  "privateKeySelectionEnabled": boolean,
  "encryptionPolicy": enum (EncryptionPolicy),
  "usbMassStorageEnabled": boolean,
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "playStoreMode": enum (PlayStoreMode),
  "setupActions": [
    {
      object (SetupAction)
    }
  ],
  "passwordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "policyEnforcementRules": [
    {
      object (PolicyEnforcementRule)
    }
  ],
  "kioskCustomization": {
    object (KioskCustomization)
  },
  "advancedSecurityOverrides": {
    object (AdvancedSecurityOverrides)
  },
  "personalUsagePolicies": {
    object (PersonalUsagePolicies)
  },
  "autoDateAndTimeZone": enum (AutoDateAndTimeZone),
  "oncCertificateProviders": [
    {
      object (OncCertificateProvider)
    }
  ],
  "crossProfilePolicies": {
    object (CrossProfilePolicies)
  },
  "preferentialNetworkService": enum (PreferentialNetworkService),
  "usageLog": {
    object (UsageLog)
  },
  "cameraAccess": enum (CameraAccess),
  "microphoneAccess": enum (MicrophoneAccess),
  "deviceConnectivityManagement": {
    object (DeviceConnectivityManagement)
  },
  "deviceRadioState": {
    object (DeviceRadioState)
  },
  "credentialProviderPolicyDefault": enum (CredentialProviderPolicyDefault),
  "printingPolicy": enum (PrintingPolicy),
  "displaySettings": {
    object (DisplaySettings)
  }
}
Campi
name

string

Il nome del criterio nel formato enterprises/{enterpriseId}/policies/{policyId}.

version

string (int64 format)

La versione del criterio. Questo campo è di sola lettura. La versione viene incrementata ogni volta che il criterio viene aggiornato.

applications[]

object (ApplicationPolicy)

Criterio applicato alle app. Può contenere al massimo 3000 elementi.

maximumTimeToLock

string (int64 format)

Tempo massimo in millisecondi per l'attività utente fino al blocco del dispositivo. Il valore 0 indica che non sono presenti limitazioni.

screenCaptureDisabled

boolean

Indica se l'acquisizione schermo è disattivata.

cameraDisabled
(deprecated)

boolean

Se cameraAccess viene impostato su un valore diverso da CAMERA_ACCESS_UNSPECIFIED, non ha alcun effetto. In caso contrario, questo campo controlla se le videocamere sono disattivate: se true, tutte le videocamere sono disattivate, altrimenti sono disponibili. Per i dispositivi completamente gestiti, questo campo si applica a tutte le app sul dispositivo. Per i profili di lavoro, questo campo si applica solo alle app nel profilo di lavoro e l'accesso alla fotocamera delle app esterne al profilo di lavoro rimane invariato.

keyguardDisabledFeatures[]

enum (KeyguardDisabledFeature)

Personalizzazioni dei blocchi tastiera disattivate, ad esempio i widget.

defaultPermissionPolicy

enum (PermissionPolicy)

Il criterio di autorizzazione predefinito per le richieste di autorizzazione di runtime.

persistentPreferredActivities[]

object (PersistentPreferredActivity)

Attività dei gestori di intent predefiniti.

openNetworkConfiguration

object (Struct format)

Configurazione di rete del dispositivo. Per saperne di più, consulta la sezione Configurare le reti.

systemUpdate

object (SystemUpdate)

Il criterio di aggiornamento di sistema, che controlla il modo in cui vengono applicati gli aggiornamenti del sistema operativo. Se il tipo di aggiornamento è WINDOWED, la finestra di aggiornamento verrà applicata automaticamente anche agli aggiornamenti delle app di Google Play.

Nota:gli aggiornamenti di sistema Google Play (chiamati anche aggiornamenti Mainline) vengono scaricati automaticamente e l'installazione richiede il riavvio del dispositivo. Per ulteriori dettagli, consulta la sezione relativa alle linee principali in Gestire gli aggiornamenti di sistema.

accountTypesWithManagementDisabled[]

string

Tipi di account che non possono essere gestiti dall'utente.

addUserDisabled

boolean

Indica se l'aggiunta di nuovi utenti e profili è disabilitata.

adjustVolumeDisabled

boolean

Indica se la regolazione del volume principale è disabilitata. Disattiva anche l'audio del dispositivo.

factoryResetDisabled

boolean

Indica se il ripristino dei dati di fabbrica dalle impostazioni è disattivato.

installAppsDisabled

boolean

Indica se l'installazione delle app da parte dell'utente è disattivata.

mountPhysicalMediaDisabled

boolean

Indica se l'utente che monta supporti esterni fisici è disabilitato.

modifyAccountsDisabled

boolean

Indica se l'aggiunta o la rimozione di account è disabilitata.

safeBootDisabled
(deprecated)

boolean

Indica se il riavvio del dispositivo in Avvio protetto è disattivato.

uninstallAppsDisabled

boolean

Indica se la disinstallazione delle applicazioni da parte dell'utente è disabilitata. In questo modo si impedisce la disinstallazione delle app, anche quelle rimosse utilizzando applications

statusBarDisabled
(deprecated)

boolean

Indica se la barra di stato è disabilitata. In questo modo vengono disattivate le notifiche, le impostazioni rapide e altri overlay sullo schermo che consentono l'uscita dalla modalità a schermo intero. OBSOLETO. Per disattivare la barra di stato su un dispositivo kiosk, utilizza InstallType KIOSK o kioskCustomLauncherEnabled.

keyguardDisabled

boolean

Se impostato su true, la schermata di blocco viene disattivata per i display principali e/o secondari.

minimumApiLevel

integer

Il livello API Android minimo consentito.

statusReportingSettings

object (StatusReportingSettings)

Impostazioni dei report sullo stato

bluetoothContactSharingDisabled

boolean

Indica se la condivisione dei contatti Bluetooth è disattivata.

shortSupportMessage

object (UserFacingMessage)

Un messaggio mostrato all'utente nella schermata delle impostazioni ogni volta che la funzionalità è stata disattivata dall'amministratore. Se il messaggio contiene più di 200 caratteri, potrebbe essere troncato.

longSupportMessage

object (UserFacingMessage)

Un messaggio mostrato all'utente nella schermata delle impostazioni dell'amministratore del dispositivo.

passwordRequirements
(deprecated)

object (PasswordRequirements)

Requisiti per le password. Il campo passwordRequirements.require_password_unlock non deve essere impostato. OBSOLETO: utilizza passwordPolicies.

Nota:

I valori basati sulla complessità di PasswordQuality, ovvero COMPLEXITY_LOW, COMPLEXITY_MEDIUM e COMPLEXITY_HIGH, non possono essere utilizzati qui. Non è possibile utilizzare unifiedLockSettings qui.

wifiConfigsLockdownEnabled
(deprecated)

boolean

OBSOLETO: utilizza wifiConfigDisabled.

bluetoothConfigDisabled

boolean

Indica se la configurazione Bluetooth è disabilitata.

cellBroadcastsConfigDisabled

boolean

Indica se la configurazione di cell broadcast è disabilitata.

credentialsConfigDisabled

boolean

Indica se la configurazione delle credenziali utente è disabilitata.

mobileNetworksConfigDisabled

boolean

Indica se la configurazione di reti mobili è disabilitata.

tetheringConfigDisabled
(deprecated)

boolean

Indica se la configurazione di tethering e hotspot portatili è disabilitata. Se il criterio tetheringSettings viene impostato su un valore diverso da TETHERING_SETTINGS_UNSPECIFIED, questa impostazione viene ignorata.

vpnConfigDisabled

boolean

Indica se la configurazione della VPN è disabilitata.

wifiConfigDisabled
(deprecated)

boolean

Indica se la configurazione di reti Wi-Fi è disabilitata. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda. Per i dispositivi completamente gestiti, l'impostazione di questo criterio su true rimuove tutte le reti configurate e conserva solo quelle configurate utilizzando openNetworkConfiguration. Per i profili di lavoro sui dispositivi di proprietà dell'azienda, le reti configurate esistenti non sono interessate e all'utente non è consentito aggiungere, rimuovere o modificare le reti Wi-Fi. Se il criterio configureWifi viene impostato su un valore diverso da CONFIGURE_WIFI_UNSPECIFIED, questa impostazione viene ignorata. Nota:se non è possibile stabilire una connessione di rete al momento dell'avvio e la configurazione della rete Wi-Fi è disattivata, viene visualizzata l'opzione di escape hatch di rete per aggiornare i criteri relativi ai dispositivi (vedi networkEscapeHatchEnabled).

createWindowsDisabled

boolean

Indica se la creazione di finestre oltre a quelle dell'app è disattivata.

networkResetDisabled

boolean

Indica se la reimpostazione delle impostazioni di rete è disattivata.

outgoingBeamDisabled

boolean

Indica se l'utilizzo di NFC per trasmettere dati dalle app è disattivato.

outgoingCallsDisabled

boolean

Indica se le chiamate in uscita sono disabilitate.

removeUserDisabled

boolean

Indica se la rimozione di altri utenti è disabilitata.

shareLocationDisabled

boolean

Indica se la Condivisione della posizione è disattivata. L'app shareLocationDisabled è supportata sia per i dispositivi completamente gestiti sia per i profili di lavoro di proprietà personale.

smsDisabled

boolean

Indica se l'invio e la ricezione di messaggi SMS sono disattivati.

unmuteMicrophoneDisabled
(deprecated)

boolean

Se microphoneAccess viene impostato su un valore diverso da MICROPHONE_ACCESS_UNSPECIFIED, non ha alcun effetto. In caso contrario, questo campo consente di controllare se i microfoni sono disabilitati: se impostato su true, tutti i microfoni sono disattivati, altrimenti sono disponibili. Questa opzione è disponibile solo sui dispositivi completamente gestiti.

usbFileTransferDisabled
(deprecated)

boolean

Indica se il trasferimento di file tramite USB è disabilitato. Questa opzione è supportata solo sui dispositivi di proprietà dell'azienda.

ensureVerifyAppsEnabled
(deprecated)

boolean

Indica se la verifica app è abilitata in modo forzato.

permittedInputMethods

object (PackageNameList)

Se presenti, sono consentiti solo i metodi di inserimento forniti dai pacchetti in questo elenco. Se questo campo è presente, ma l'elenco è vuoto, sono consentiti solo i metodi di immissione del sistema.

stayOnPluggedModes[]

enum (BatteryPluggedMode)

La batteria è collegata nelle modalità in cui il dispositivo rimane acceso. Quando utilizzi questa impostazione, ti consigliamo di cancellare i dati di maximumTimeToLock in modo che il dispositivo non si chiuda automaticamente mentre rimane acceso.

recommendedGlobalProxy

object (ProxyInfo)

Il proxy HTTP globale indipendente dalla rete. In genere i proxy devono essere configurati in base alla rete in openNetworkConfiguration. Tuttavia, per configurazioni insolite come filtri interni generici può essere utile un proxy HTTP globale. Se il proxy non è accessibile, l'accesso alla rete potrebbe non essere disponibile. Il proxy globale è solo un suggerimento e alcune app potrebbero ignorarlo.

setUserIconDisabled

boolean

Indica se la modifica dell'icona utente è disabilitata.

setWallpaperDisabled

boolean

Indica se la modifica dello sfondo è disattivata.

choosePrivateKeyRules[]

object (ChoosePrivateKeyRule)

Regole per determinare le app l'accesso alle chiavi private. Per ulteriori dettagli, consulta ChoosePrivateKeyRule. Il campo deve essere vuoto se un'applicazione ha un ambito di delega CERT_SELECTION.

alwaysOnVpnPackage

object (AlwaysOnVpnPackage)

Configurazione per una connessione VPN sempre attiva. Utilizzala con vpnConfigDisabled per impedire la modifica di questa impostazione.

frpAdminEmails[]

string

Indirizzi email degli amministratori del dispositivo per la protezione dal ripristino dei dati di fabbrica. Al ripristino dei dati di fabbrica, uno di questi amministratori dovrà accedere con l'indirizzo email e la password dell'Account Google per sbloccare il dispositivo. Se non viene specificato alcun amministratore, il dispositivo non fornirà la protezione ripristino dati di fabbrica.

deviceOwnerLockScreenInfo

object (UserFacingMessage)

Le informazioni del proprietario del dispositivo da mostrare nella schermata di blocco.

dataRoamingDisabled

boolean

Indica se i servizi di dati in roaming sono disattivati.

locationMode

enum (LocationMode)

Il grado di rilevamento della posizione attivato.

networkEscapeHatchEnabled

boolean

Indica se l'escape hatch di rete è abilitato. Se non è possibile stabilire una connessione di rete al momento dell'avvio, l'escape hatch chiede all'utente di connettersi temporaneamente a una rete per aggiornare i criteri relativi ai dispositivi. Dopo aver applicato il criterio, la rete temporanea verrà eliminata e il dispositivo continuerà ad avviarsi. In questo modo non è possibile connettersi a una rete se non esiste una rete adatta nell'ultimo criterio e il dispositivo si avvia in un'app in modalità di blocco attività oppure se l'utente non riesce a raggiungere le impostazioni del dispositivo.

Nota: l'impostazione di wifiConfigDisabled su true sostituirà questa impostazione in determinate circostanze. Per ulteriori dettagli, visita la pagina wifiConfigDisabled. L'impostazione del criterio configureWifi su DISALLOW_CONFIGURING_WIFI sostituirà questa impostazione in determinate circostanze. Per ulteriori dettagli, visita la pagina DISALLOW_CONFIGURING_WIFI.

bluetoothDisabled

boolean

Indica se il Bluetooth è disattivato. Preferisci questa impostazione rispetto a bluetoothConfigDisabled perché bluetoothConfigDisabled può essere ignorato dall'utente.

complianceRules[]
(deprecated)

object (ComplianceRule)

Regole che dichiarano quali azioni mitiganti intraprendere quando un dispositivo non è conforme alle relative norme. Quando sono soddisfatte le condizioni di più regole, vengono intraprese tutte le azioni di attenuazione per le regole. Il numero massimo di regole è 100. Utilizza invece le regole di applicazione dei criteri.

blockApplicationsEnabled
(deprecated)

boolean

Indica se l'installazione di applicazioni diverse da quelle configurate in applications viene bloccata. Se impostato, le applicazioni che sono state installate in base a un criterio precedente, ma che non sono più visualizzate nel criterio, vengono disinstallate automaticamente.

installUnknownSourcesAllowed
(deprecated)

boolean

Questo campo non ha alcun effetto.

debuggingFeaturesAllowed
(deprecated)

boolean

Indica se l'utente può attivare le funzionalità di debug.

funDisabled

boolean

Se l'utente può divertirsi. Consente di stabilire se il gioco dell'Easter egg nelle Impostazioni è disattivato.

autoTimeRequired
(deprecated)

boolean

Indica se è richiesta l'ora automatica, impedendo così all'utente di impostare manualmente la data e l'ora. Se autoDateAndTimeZone è impostato, questo campo viene ignorato.

permittedAccessibilityServices

object (PackageNameList)

Specifica i servizi di accessibilità consentiti. Se il campo non viene configurato, è possibile utilizzare qualsiasi servizio di accessibilità. Se il campo è impostato, è possibile usare soltanto i servizi di accessibilità presenti in questo elenco e il servizio di accessibilità integrato del sistema. In particolare, se il campo è vuoto, è possibile utilizzare solo i servizi di accessibilità integrati del sistema. Questa opzione può essere impostata sui dispositivi completamente gestiti e sui profili di lavoro. Quando è applicato a un profilo di lavoro, influisce sia sul profilo personale sia sul profilo di lavoro.

appAutoUpdatePolicy

enum (AppAutoUpdatePolicy)

Alternativa consigliata: l'attributo autoUpdateMode, che viene impostato per singola app, offre una maggiore flessibilità per quanto riguarda la frequenza di aggiornamento.

Se autoUpdateMode viene impostato su AUTO_UPDATE_POSTPONED o AUTO_UPDATE_HIGH_PRIORITY, questo campo non ha alcun effetto.

Il criterio di aggiornamento automatico delle app, che consente di stabilire quando è possibile applicare gli aggiornamenti automatici delle app.

kioskCustomLauncherEnabled

boolean

Indica se è abilitata l'Avvio app kiosk personalizzato. La schermata Home viene sostituita con un'Avvio app che blocca il dispositivo per le app installate tramite l'impostazione applications. Le app sono visualizzate in una singola pagina in ordine alfabetico. Utilizza kioskCustomization per configurare ulteriormente il comportamento del dispositivo kiosk.

androidDevicePolicyTracks[]
(deprecated)

enum (AppTrack)

Questa impostazione non è supportata. Qualsiasi valore viene ignorato.

skipFirstUseHintsEnabled

boolean

Segnala per saltare i suggerimenti al primo utilizzo. L'amministratore aziendale può attivare il suggerimento di sistema che consente alle app di ignorare il tutorial per gli utenti e altri suggerimenti introduttivi al primo avvio.

privateKeySelectionEnabled

boolean

Consente di mostrare l'UI su un dispositivo per consentire a un utente di scegliere un alias di chiave privata se non ci sono regole corrispondenti in ChoosePrivateKeyRules. Per i dispositivi con versioni precedenti ad Android P, questa impostazione potrebbe rendere vulnerabili le chiavi aziendali. Questo valore non avrà effetto se l'ambito di delega per un'applicazione è CERT_SELECTION.

encryptionPolicy

enum (EncryptionPolicy)

Se la crittografia è abilitata

usbMassStorageEnabled
(deprecated)

boolean

Se l'archivio USB è attivato. Deprecato.

permissionGrants[]

object (PermissionGrant)

Autorizzazioni o rifiuti di gruppo espliciti per tutte le app. Questi valori sostituiscono il valore defaultPermissionPolicy.

playStoreMode

enum (PlayStoreMode)

Questa modalità controlla quali app sono disponibili per l'utente nel Play Store e il relativo comportamento sul dispositivo quando le app vengono rimosse dal criterio.

setupActions[]

object (SetupAction)

Azione da intraprendere durante il processo di configurazione. È possibile specificare al massimo un'azione.

passwordPolicies[]

object (PasswordRequirements)

Criteri relativi ai requisiti delle password. È possibile impostare criteri diversi per il profilo di lavoro o per i dispositivi completamente gestiti impostando il campo passwordScope nel criterio.

policyEnforcementRules[]

object (PolicyEnforcementRule)

Regole che definiscono il comportamento quando un determinato criterio non può essere applicato sul dispositivo

kioskCustomization

object (KioskCustomization)

Impostazioni che gestiscono il comportamento di un dispositivo in modalità kiosk. Per attivare la modalità kiosk, imposta kioskCustomLauncherEnabled su true o specifica un'app nel criterio con installType KIOSK.

advancedSecurityOverrides

object (AdvancedSecurityOverrides)

Impostazioni di sicurezza avanzate. Nella maggior parte dei casi, non è necessario configurarli.

personalUsagePolicies

object (PersonalUsagePolicies)

Criteri che gestiscono l'utilizzo personale su un dispositivo di proprietà dell'azienda.

autoDateAndTimeZone

enum (AutoDateAndTimeZone)

Indica se la data, l'ora e il fuso orario sono abilitati su un dispositivo di proprietà dell'azienda. Se questo criterio viene impostato, autoTimeRequired viene ignorato.

oncCertificateProviders[]

object (OncCertificateProvider)

Questa funzionalità non è disponibile a livello generale.

crossProfilePolicies

object (CrossProfilePolicies)

Criteri di più profili applicati al dispositivo.

preferentialNetworkService

enum (PreferentialNetworkService)

Consente di controllare se il servizio di rete preferenziale è abilitato sul profilo di lavoro. Ad esempio, un'organizzazione potrebbe avere un accordo con un vettore per indicare che tutti i dati di lavoro dei suoi dipendenti dispositivi verranno inviati tramite un servizio di rete dedicato all'uso aziendale. Un esempio di servizio di rete preferenziale supportato è la sezione aziendale sulle reti 5G. Questa operazione non ha alcun effetto sui dispositivi completamente gestiti.

usageLog

object (UsageLog)

Configurazione del logging delle attività del dispositivo.

cameraAccess

enum (CameraAccess)

Controlla l'utilizzo della fotocamera e se l'utente ha accesso all'opzione di attivazione/disattivazione dell'accesso alla fotocamera.

microphoneAccess

enum (MicrophoneAccess)

Consente di controllare l'utilizzo del microfono e se l'utente ha accesso all'opzione di attivazione/disattivazione del microfono. Si applica solo ai dispositivi completamente gestiti.

deviceConnectivityManagement

object (DeviceConnectivityManagement)

Include i controlli per la connettività dei dispositivi, ad esempio Wi-Fi, accesso ai dati USB, connessioni tastiera/mouse e altro ancora.

deviceRadioState

object (DeviceRadioState)

Copre i controlli per lo stato della radio, ad esempio Wi-Fi, Bluetooth e altri.

credentialProviderPolicyDefault

enum (CredentialProviderPolicyDefault)

Consente di stabilire quali app possono fungere da fornitori di credenziali su Android 14 e versioni successive. Queste app memorizzano le credenziali. Per informazioni dettagliate, vedi questo e questo. Vedi anche credentialProviderPolicy.

printingPolicy

enum (PrintingPolicy)

(Facoltativo) Consente di stabilire se la stampa è consentita. Questa opzione è supportata sui dispositivi con Android 9 e versioni successive. .

displaySettings

object (DisplaySettings)

(Facoltativo) Controlli per le impostazioni di visualizzazione.

ApplicationPolicy

Norma per una singola app. Nota: la disponibilità dell'applicazione su un determinato dispositivo non può essere modificata utilizzando questo criterio se installAppsDisabled è attivato. Il numero massimo di applicazioni che puoi specificare per criterio è 3000.

Rappresentazione JSON
{
  "packageName": string,
  "installType": enum (InstallType),
  "lockTaskAllowed": boolean,
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "managedConfiguration": {
    object
  },
  "disabled": boolean,
  "minimumVersionCode": integer,
  "delegatedScopes": [
    enum (DelegatedScope)
  ],
  "managedConfigurationTemplate": {
    object (ManagedConfigurationTemplate)
  },
  "accessibleTrackIds": [
    string
  ],
  "connectedWorkAndPersonalApp": enum (ConnectedWorkAndPersonalApp),
  "autoUpdateMode": enum (AutoUpdateMode),
  "extensionConfig": {
    object (ExtensionConfig)
  },
  "alwaysOnVpnLockdownExemption": enum (AlwaysOnVpnLockdownExemption),
  "workProfileWidgets": enum (WorkProfileWidgets),
  "credentialProviderPolicy": enum (CredentialProviderPolicy),
  "installConstraint": [
    {
      object (InstallConstraint)
    }
  ],
  "installPriority": integer,
  "userControlSettings": enum (UserControlSettings)
}
Campi
packageName

string

Il nome del pacchetto dell'app. Ad esempio, com.google.android.youtube per l'app YouTube.

installType

enum (InstallType)

Il tipo di installazione da eseguire.

lockTaskAllowed
(deprecated)

boolean

Indica se l'app può bloccarsi in modalità a schermo intero. OBSOLETO. Usa InstallType KIOSK o kioskCustomLauncherEnabled per configurare un dispositivo dedicato.

defaultPermissionPolicy

enum (PermissionPolicy)

Il criterio predefinito per tutte le autorizzazioni richieste dall'app. Se specificato, sostituisce il criterio defaultPermissionPolicy a livello di criterio che viene applicato a tutte le app. Non sostituisce il permissionGrants che si applica a tutte le app.

permissionGrants[]

object (PermissionGrant)

Rifiuti o concessioni di autorizzazioni esplicite per l'app. Questi valori sostituiscono i valori defaultPermissionPolicy e permissionGrants che si applicano a tutte le app.

managedConfiguration

object (Struct format)

Configurazione gestita applicata all'app. Il formato della configurazione è dettato dai valori ManagedProperty supportati dall'app. Ciascun nome di campo nella configurazione gestita deve corrispondere al campo key di ManagedProperty. Il valore del campo deve essere compatibile con type di ManagedProperty:

typeValore JSON
BOOLtrue o false
STRINGstringa
INTEGERnumero
CHOICEstringa
MULTISELECTarray di stringhe
HIDDENstringa
BUNDLE_ARRAYarray di oggetti

disabled

boolean

Indica se l'app è disabilitata. Se l'opzione è disattivata, i dati dell'app vengono comunque conservati.

minimumVersionCode

integer

La versione minima dell'app eseguita sul dispositivo. Se impostato, il dispositivo tenta di aggiornare l'app almeno a questo codice di versione. Se l'app non è aggiornata, il dispositivo conterrà un valore NonComplianceDetail con nonComplianceReason impostato su APP_NOT_UPDATED. L'app deve essere già pubblicata su Google Play con un codice di versione superiore o uguale a questo valore. Al massimo 20 app possono specificare un codice di versione minimo per criterio.

delegatedScopes[]

enum (DelegatedScope)

Gli ambiti delegati all'app da Android Device Policy. Queste offrono privilegi aggiuntivi per le applicazioni a cui vengono applicati.

managedConfigurationTemplate

object (ManagedConfigurationTemplate)

Il modello di configurazioni gestite per l'app, salvato dall'iframe delle configurazioni gestite. Questo campo viene ignorato se è impostato managedConfiguration.

accessibleTrackIds[]

string

Elenco di ID canale dell'app a cui può accedere un dispositivo appartenente all'azienda. Se l'elenco contiene più ID canale, i dispositivi ricevono la versione più recente tra tutti i canali accessibili. Se l'elenco non contiene ID canale, i dispositivi hanno accesso soltanto al canale di produzione dell'app. Ulteriori dettagli su ogni traccia sono disponibili in AppTrackInfo.

connectedWorkAndPersonalApp

enum (ConnectedWorkAndPersonalApp)

Consente di stabilire se l'app può comunicare con se stessa nei profili di lavoro e personale di un dispositivo, previa autorizzazione dell'utente.

autoUpdateMode

enum (AutoUpdateMode)

Consente di controllare la modalità di aggiornamento automatico dell'app.

extensionConfig

object (ExtensionConfig)

Configurazione per attivare questa app come app di estensione, con la possibilità di interagire con Android Device Policy offline.

Questo campo può essere impostato per un massimo di un'app.

alwaysOnVpnLockdownExemption

enum (AlwaysOnVpnLockdownExemption)

Specifica se all'app è consentito il networking quando la VPN non è connessa e alwaysOnVpnPackage.lockdownEnabled è abilitato. Se il criterio viene impostato su VPN_LOCKDOWN_ENFORCED, non è consentito il networking dell'app. Se invece viene impostato su VPN_LOCKDOWN_EXEMPTION, l'app è autorizzata a eseguire il networking. Funzionalità supportata solo su dispositivi con Android 10 e versioni successive. Se non è supportato dal dispositivo, quest'ultimo conterrà un valore NonComplianceDetail con nonComplianceReason impostato su API_LEVEL e un fieldPath. Se questo non è applicabile all'app, il dispositivo conterrà un valore NonComplianceDetail con nonComplianceReason impostato su UNSUPPORTED e un fieldPath. Il campo fieldPath è impostato su applications[i].alwaysOnVpnLockdownExemption, dove i è l'indice del pacchetto nel criterio applications.

workProfileWidgets

enum (WorkProfileWidgets)

Specifica se l'app installata nel profilo di lavoro può aggiungere widget alla schermata Home.

credentialProviderPolicy

enum (CredentialProviderPolicy)

(Facoltativo) Indica se l'app è autorizzata ad agire come fornitore di credenziali su Android 14 e versioni successive.

installConstraint[]

object (InstallConstraint)

(Facoltativo) I vincoli per l'installazione dell'app. Puoi specificare un massimo di InstallConstraint. Più vincoli vengono rifiutati.

installPriority

integer

(Facoltativo) Tra le app con installType impostata su:

questa opzione controlla la priorità relativa dell'installazione. Se il valore è 0 (valore predefinito), questa app non ha priorità su altre app. Per i valori compresi tra 1 e 10.000, un valore più basso indica una priorità più alta. I valori al di fuori dell'intervallo compreso tra 0 e 10.000 inclusi vengono rifiutati.

userControlSettings

enum (UserControlSettings)

(Facoltativo) Specifica se il controllo utente è consentito per l'app. Il controllo utente include azioni degli utenti quali l'interruzione forzata e la cancellazione dei dati dell'app. Funzionalità supportata su Android 11 e versioni successive.

InstallType

Il tipo di installazione da eseguire per un'app. Se setupAction fa riferimento a un'app, deve avere installType impostato come REQUIRED_FOR_SETUP, altrimenti la configurazione non andrà a buon fine.

Enum
INSTALL_TYPE_UNSPECIFIED Non specificato. Il valore predefinito è AVAILABLE.
PREINSTALLED L'app viene installata automaticamente e può essere rimossa dall'utente.
FORCE_INSTALLED L'app viene installata automaticamente indipendentemente dal periodo di manutenzione impostato e non può essere rimossa dall'utente.
BLOCKED L'app è bloccata e non può essere installata. Se l'app è stata installata in base a un criterio precedente, verrà disinstallata. L'operazione blocca anche la funzionalità dell'app istantanea.
AVAILABLE L'app è disponibile per l'installazione.
REQUIRED_FOR_SETUP L'app viene installata automaticamente, non può essere rimossa dall'utente e ne impedirà il completamento fino al termine dell'installazione.
KIOSK L'app viene installata automaticamente in modalità kiosk: è impostata come intent domestico preferito e viene autorizzata per la modalità di blocco dell'attività. La configurazione del dispositivo non sarà completata finché l'app non sarà installata. Dopo l'installazione, gli utenti non potranno più rimuovere l'app. Puoi impostare installType solo per un'app per criterio. Se è presente nel criterio, la barra di stato viene disattivata automaticamente.

PermissionPolicy

Il criterio per concedere richieste di autorizzazione alle app.

Enum
PERMISSION_POLICY_UNSPECIFIED Criterio non specificato. Se per un'autorizzazione non viene specificato alcun criterio a nessun livello, per impostazione predefinita viene utilizzato il comportamento PROMPT.
PROMPT Chiedi all'utente di concedere un'autorizzazione.
GRANT

Concedi automaticamente un'autorizzazione.

Su Android 12 e versioni successive, Manifest.permission.READ_SMS e le seguenti autorizzazioni relative ai sensori possono essere concesse solo su dispositivi completamente gestiti:

DENY Negare automaticamente un'autorizzazione.

PermissionGrant

Configurazione di un'autorizzazione Android e stato di concessione.

Rappresentazione JSON
{
  "permission": string,
  "policy": enum (PermissionPolicy)
}
Campi
permission

string

L'autorizzazione o il gruppo di Android, ad esempio android.permission.READ_CALENDAR o android.permission_group.CALENDAR.

policy

enum (PermissionPolicy)

Il criterio per concedere l'autorizzazione.

DelegatedScope

Ambiti delle deleghe che un altro pacchetto può acquisire da Android Device Policy. Queste offrono privilegi aggiuntivi per le applicazioni a cui vengono applicati.

Gli ambiti possono essere applicati a più applicazioni, ad eccezione di SECURITY_LOGS e NETWORK_ACTIVITY_LOGS, che possono essere delegati a una sola app alla volta.

Enum
DELEGATED_SCOPE_UNSPECIFIED Nessun ambito di delega specificato.
CERT_INSTALL Concede l'accesso all'installazione e alla gestione dei certificati.
MANAGED_CONFIGURATIONS Concede l'accesso alla gestione delle configurazioni gestite.
BLOCK_UNINSTALL Concede l'accesso per bloccare la disinstallazione.
PERMISSION_GRANT Concede l'accesso ai criteri e allo stato di concessione dell'autorizzazione.
PACKAGE_ACCESS Concede l'accesso allo stato di accesso al pacchetto.
ENABLE_SYSTEM_APP Concede l'accesso per abilitare le app di sistema.
NETWORK_ACTIVITY_LOGS Concede l'accesso ai log delle attività di rete. Consente all'applicazione delegata di chiamare i metodi setNetworkLoggingEnabled, isNetworkLoggingEnabled e retrieveNetworkLogs. Questo ambito può essere delegato al massimo a un'applicazione. Impostazione supportata per i dispositivi completamente gestiti su Android 10 e versioni successive. Funzionalità supportata per un profilo di lavoro su Android 12 e versioni successive. Quando la delega è supportata e impostata, il criterio NETWORK_ACTIVITY_LOGS viene ignorato.
SECURITY_LOGS Concede l'accesso ai log di sicurezza. Consente all'applicazione delegata di chiamare i metodi setSecurityLoggingEnabled, isSecurityLoggingEnabled, retrieveSecurityLogs e retrievePreRebootSecurityLogs. Questo ambito può essere delegato al massimo a un'applicazione. Impostazione supportata per i dispositivi completamente gestiti e di proprietà dell'azienda con un profilo di lavoro su Android 12 e versioni successive. Quando la delega è supportata e impostata, il criterio SECURITY_LOGS viene ignorato.
CERT_SELECTION Concede l'accesso alla selezione di certificati KeyChain per conto delle richieste di app. Una volta concessa, l'applicazione delegata inizierà a ricevere DelegatedAdminReceiver#onChoosePrivateKeyAlias. Consente all'applicazione delegata di chiamare i metodi grantKeyPairToApp e revokeKeyPairFromApp. Può esserci al massimo un'app con questa delega. Il campo choosePrivateKeyRules deve essere vuoto e privateKeySelectionEnabled non ha alcun effetto se la selezione del certificato viene delegata a un'applicazione.

ManagedConfigurationTemplate

Il modello di configurazioni gestite per l'app, salvato dall'iframe delle configurazioni gestite.

Rappresentazione JSON
{
  "templateId": string,
  "configurationVariables": {
    string: string,
    ...
  }
}
Campi
templateId

string

L'ID del modello di configurazioni gestite.

configurationVariables

map (key: string, value: string)

Facoltativo, una mappa contenente <key, value> di configurazione definite per la configurazione.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ConnectedWorkAndPersonalApp

Consente di stabilire se l'app può comunicare con se stessa in più profili, in base al consenso dell'utente.

Enum
CONNECTED_WORK_AND_PERSONAL_APP_UNSPECIFIED Non specificato. Il valore predefinito è CONNECTED_WORK_AND_PERSONAL_APPS_DISALLOWED.
CONNECTED_WORK_AND_PERSONAL_APP_DISALLOWED Predefinita. Impedisce all'app di comunicare tra profili.
CONNECTED_WORK_AND_PERSONAL_APP_ALLOWED Consente all'app di comunicare tra profili dopo aver ricevuto il consenso dell'utente.

AutoUpdateMode

Consente di controllare la modalità di aggiornamento automatico dell'app. Se un utente modifica manualmente le impostazioni del dispositivo, queste scelte vengono ignorate da AutoUpdateMode, che ha la precedenza.

Enum
AUTO_UPDATE_MODE_UNSPECIFIED Non specificato. Il valore predefinito è AUTO_UPDATE_DEFAULT.
AUTO_UPDATE_DEFAULT

La modalità di aggiornamento predefinita.

L'app viene aggiornata automaticamente con una priorità bassa per ridurre al minimo l'impatto sull'utente.

L'app viene aggiornata quando vengono soddisfatti tutti i seguenti vincoli:

  • Il dispositivo non è utilizzato attivamente.
  • Il dispositivo è connesso a una rete unmetered.
  • Il dispositivo è in carica.
  • L'app da aggiornare non è in esecuzione in primo piano.

Il dispositivo viene avvisato di un nuovo aggiornamento entro 24 ore dalla sua pubblicazione da parte dello sviluppatore. Trascorso questo periodo l'app viene aggiornata la volta successiva che vengono soddisfatti i vincoli sopra indicati.

AUTO_UPDATE_POSTPONED

L'app non viene aggiornata automaticamente per un massimo di 90 giorni dopo che è diventata obsoleta.

90 giorni dopo che l'app diventa obsoleta, l'ultima versione disponibile viene installata automaticamente con priorità bassa (vedi AUTO_UPDATE_DEFAULT). Una volta aggiornata, l'app viene aggiornata di nuovo automaticamente solo 90 giorni dopo che diventa di nuovo obsoleta.

L'utente può comunque aggiornare manualmente l'app dal Play Store in qualsiasi momento.

AUTO_UPDATE_HIGH_PRIORITY

L'app viene aggiornata il prima possibile. Nessun vincolo applicato.

Il dispositivo viene informato appena possibile di un nuovo aggiornamento quando diventa disponibile.

NOTA:gli aggiornamenti delle app con implementazioni di maggiori dimensioni nell'ecosistema Android possono richiedere fino a 24 ore.

ExtensionConfig

Configurazione per attivare un'app come estensione, con la possibilità di interagire con Android Device Policy offline. Per le versioni Android 13 e successive, le app di estensioni sono esenti dalle limitazioni della batteria, quindi non verranno inserite nel bucket di standby delle app limitato. Inoltre, le app con estensioni sono protette contro la cancellazione dei dati o la chiusura forzata dell'applicazione da parte degli utenti, anche se gli amministratori possono continuare a utilizzare clear app data command nelle app con estensioni se necessario per Android 13 e versioni successive.

Rappresentazione JSON
{
  "signingKeyFingerprintsSha256": [
    string
  ],
  "notificationReceiver": string
}
Campi
signingKeyFingerprintsSha256[]

string

Hash SHA-256 con codifica esadecimale del certificato di firma dell'app dell'estensione. Sono valide solo rappresentazioni stringa esadecimali di 64 caratteri.

Se non specificata, la firma del nome del pacchetto corrispondente viene ottenuta dal Play Store.

Se questo elenco è vuoto, la firma dell'app dell'estensione sul dispositivo deve corrispondere a quella ottenuta dal Play Store affinché l'app possa comunicare con Android Device Policy.

Se questo elenco non è vuoto, la firma dell'app dell'estensione sul dispositivo deve corrispondere a una delle voci dell'elenco affinché l'app possa comunicare con Android Device Policy.

Nei casi d'uso di produzione, consigliamo di lasciare vuoto questo campo.

notificationReceiver

string

Nome completo della classe del servizio destinatario per Android Device Policy per notificare all'app dell'estensione eventuali aggiornamenti dello stato dei comandi locali.

AlwaysOnVpnLockdownExemption

Consente di stabilire se un'app è esente dall'impostazione alwaysOnVpnPackage.lockdownEnabled.

Enum
ALWAYS_ON_VPN_LOCKDOWN_EXEMPTION_UNSPECIFIED Non specificato. Il valore predefinito è VPN_LOCKDOWN_ENFORCED.
VPN_LOCKDOWN_ENFORCED L'app rispetta l'impostazione di blocco della VPN sempre attiva.
VPN_LOCKDOWN_EXEMPTION L'app è esente dall'impostazione di blocco della VPN sempre attiva.

WorkProfileWidgets

Consente di stabilire se un'applicazione del profilo di lavoro può aggiungere widget alla schermata Home.

Enum
WORK_PROFILE_WIDGETS_UNSPECIFIED Non specificato. Il valore predefinito è workProfileWidgetsDefault
WORK_PROFILE_WIDGETS_ALLOWED I widget del profilo di lavoro sono consentiti. Ciò significa che l'applicazione potrà aggiungere widget alla schermata Home.
WORK_PROFILE_WIDGETS_DISALLOWED I widget del profilo di lavoro non sono consentiti. Ciò significa che l'applicazione non potrà aggiungere widget alla schermata Home.

CredentialProviderPolicy

Indica se l'app è autorizzata ad agire come fornitore di credenziali su Android 14 e versioni successive.

Enum
CREDENTIAL_PROVIDER_POLICY_UNSPECIFIED Non specificato. Il comportamento è regolato da credentialProviderPolicyDefault.
CREDENTIAL_PROVIDER_ALLOWED L'app è autorizzata ad agire come fornitore di credenziali.

InstallConstraint

Tra le app con InstallType impostata su:

che definisce un insieme di limitazioni per l'installazione dell'app. È necessario impostare almeno uno dei campi. Se sono impostati più campi, per poter installare l'app devono essere soddisfatti tutti i vincoli.

Rappresentazione JSON
{
  "networkTypeConstraint": enum (NetworkTypeConstraint),
  "chargingConstraint": enum (ChargingConstraint),
  "deviceIdleConstraint": enum (DeviceIdleConstraint)
}
Campi
networkTypeConstraint

enum (NetworkTypeConstraint)

(Facoltativo) Vincolo del tipo di rete.

chargingConstraint

enum (ChargingConstraint)

(Facoltativo) Vincolo di ricarica.

deviceIdleConstraint

enum (DeviceIdleConstraint)

(Facoltativo) Vincolo di inattività del dispositivo.

NetworkTypeConstraint

Vincolo del tipo di rete.

Enum
NETWORK_TYPE_CONSTRAINT_UNSPECIFIED Non specificato. Il valore predefinito è INSTALL_ON_ANY_NETWORK.
INSTALL_ON_ANY_NETWORK Qualsiasi rete attiva (Wi-Fi, cellulare e così via).
INSTALL_ONLY_ON_UNMETERED_NETWORK Qualsiasi rete illimitata (ad es. Wi-Fi).

ChargingConstraint

Vincolo di ricarica.

Enum
CHARGING_CONSTRAINT_UNSPECIFIED Non specificato. Il valore predefinito è CHARGING_NOT_REQUIRED.
CHARGING_NOT_REQUIRED Non è necessario che il dispositivo sia in carica.
INSTALL_ONLY_WHEN_CHARGING Il dispositivo deve essere in carica.

DeviceIdleConstraint

Vincolo di stato di inattività del dispositivo.

Enum
DEVICE_IDLE_CONSTRAINT_UNSPECIFIED Non specificato. Il valore predefinito è DEVICE_IDLE_NOT_REQUIRED.
DEVICE_IDLE_NOT_REQUIRED Non è necessario che il dispositivo sia inattivo: l'app può essere installata mentre l'utente interagisce con il dispositivo.
INSTALL_ONLY_WHEN_DEVICE_IDLE Il dispositivo deve essere inattivo.

UserControlSettings

Specifica se il controllo utente è consentito per una determinata app. Il controllo utente include azioni degli utenti quali l'interruzione forzata e la cancellazione dei dati dell'app. Funzionalità supportata su Android 11 e versioni successive. Se il criterio extensionConfig viene impostato per un'app, il controllo utente non è consentito a prescindere dal valore impostato. Per le app kiosk, è possibile utilizzare USER_CONTROL_ALLOWED per consentire il controllo utente.

Enum
USER_CONTROL_SETTINGS_UNSPECIFIED Utilizza il comportamento predefinito dell'app per determinare se il controllo utente è consentito o non consentito. Per la maggior parte delle app, il controllo utente è consentito per impostazione predefinita, ma per alcune app critiche come le app companion (extensionConfig impostato su true), le app kiosk e altre app di sistema fondamentali non è consentito.
USER_CONTROL_ALLOWED Il controllo utente è consentito per l'app. Le app kiosk possono utilizzare questa impostazione per consentire il controllo da parte degli utenti.
USER_CONTROL_DISALLOWED Il controllo utente non è consentito per l'app. Se la versione di Android è precedente alla 11, viene segnalata la presenza di API_LEVEL.

KeyguardDisabledFeature

Funzionalità di blocco della tastiera (schermata di blocco) che possono essere disattivate.

Enum
KEYGUARD_DISABLED_FEATURE_UNSPECIFIED Questo valore viene ignorato.
CAMERA Disattiva la fotocamera nelle schermate di protezione della tastiera sicure (ad esempio, PIN).
NOTIFICATIONS Disattiva la visualizzazione di tutte le notifiche in schermate protette della tastiera.
UNREDACTED_NOTIFICATIONS Disattiva le notifiche non oscurate nelle schermate con protezione della tastiera sicure.
TRUST_AGENTS Ignora lo stato dell'agente di attendibilità nelle schermate con protezione della tastiera sicure.
DISABLE_FINGERPRINT Disattiva il sensore di impronte digitali nelle schermate protette della tastiera.
DISABLE_REMOTE_INPUT Sui dispositivi con Android 6 e versioni precedenti, viene disattivato l'inserimento di testo nelle notifiche nelle schermate con protezioni della tastiera sicure. Non ha alcun effetto su Android 7 e versioni successive.
FACE Disattiva l'autenticazione dei volti nelle schermate protette della tastiera.
IRIS Disattiva l'autenticazione iris nelle schermate con protezione della tastiera sicure.
BIOMETRICS Disattiva tutte le autenticazioni biometriche nelle schermate sicure della tastiera.
SHORTCUTS Disattiva tutte le scorciatoie nella schermata con protezione della tastiera sicura su Android 14 e versioni successive.
ALL_FEATURES Disattiva tutte le personalizzazioni attuali e future del blocco tastiera.

PersistentPreferredActivity

Un'attività predefinita per la gestione di intent che corrispondono a un determinato filtro per intent. Nota:per configurare un kiosk, utilizza InstallType su KIOSK anziché attività preferite permanenti.

Rappresentazione JSON
{
  "receiverActivity": string,
  "actions": [
    string
  ],
  "categories": [
    string
  ]
}
Campi
receiverActivity

string

L'attività che dovrebbe essere il gestore di intent predefinito. Deve essere il nome di un componente Android, ad esempio com.android.enterprise.app/.MainActivity. In alternativa, il valore può essere il nome del pacchetto di un'app, il che fa sì che Android Device Policy scelga un'attività appropriata dell'app per gestire l'intent.

actions[]

string

Le azioni di intent da trovare nel filtro. Se nel filtro sono incluse azioni, l'azione di un intent deve essere uno di questi valori per avere una corrispondenza. Se non viene inclusa alcuna azione, l'azione per intent viene ignorata.

categories[]

string

Le categorie di intent da trovare nel filtro. Un intent include le categorie richieste, che devono essere tutte incluse nel filtro per creare una corrispondenza. In altre parole, l'aggiunta di una categoria al filtro non influisce sulla corrispondenza, a meno che tale categoria non sia specificata nell'intent.

SystemUpdate

Configurazione per la gestione degli aggiornamenti di sistema

Nota:gli aggiornamenti di sistema Google Play (chiamati anche aggiornamenti Mainline) vengono scaricati automaticamente, ma l'installazione richiede il riavvio del dispositivo. Per ulteriori dettagli, consulta la sezione relativa alle linee principali in Gestire gli aggiornamenti di sistema.

Rappresentazione JSON
{
  "type": enum (SystemUpdateType),
  "startMinutes": integer,
  "endMinutes": integer,
  "freezePeriods": [
    {
      object (FreezePeriod)
    }
  ]
}
Campi
type

enum (SystemUpdateType)

Il tipo di aggiornamento di sistema da configurare.

startMinutes

integer

Se il tipo è WINDOWED, l'inizio del periodo di manutenzione, misurato come il numero di minuti dopo la mezzanotte nell'ora locale del dispositivo. Questo valore deve essere compreso tra 0 e 1439 inclusi.

endMinutes

integer

Se il tipo è WINDOWED, la fine del periodo di manutenzione, misurata come il numero di minuti dopo la mezzanotte nell'ora locale del dispositivo. Questo valore deve essere compreso tra 0 e 1439 inclusi. Se questo valore è inferiore a startMinutes, il periodo di manutenzione dura la mezzanotte. Se il periodo di manutenzione specificato è inferiore a 30 minuti, il periodo effettivo viene esteso a 30 minuti oltre l'ora di inizio.

freezePeriods[]

object (FreezePeriod)

Un periodo di tempo ricorrente di un anno in cui gli aggiornamenti di sistema over-the-air (OTA) vengono posticipati per bloccare la versione del sistema operativo in esecuzione su un dispositivo. Per evitare che il dispositivo si blocchi a tempo indeterminato, ogni periodo di blocco deve essere separato da almeno 60 giorni.

SystemUpdateType

Il tipo di configurazione dell'aggiornamento di sistema.

Enum
SYSTEM_UPDATE_TYPE_UNSPECIFIED Segui il comportamento di aggiornamento predefinito per il dispositivo, che in genere richiede all'utente di accettare gli aggiornamenti di sistema.
AUTOMATIC Installa automaticamente non appena è disponibile un aggiornamento.
WINDOWED

Installa automaticamente entro un periodo di manutenzione giornaliera. In questo modo, inoltre, configuri le app di Google Play in modo che vengano aggiornate all'interno della finestra. Questa opzione è vivamente consigliata per i dispositivi kiosk perché è l'unico modo in cui le app bloccate costantemente in primo piano possono essere aggiornate da Play.

Se il criterio autoUpdateMode è impostato su AUTO_UPDATE_HIGH_PRIORITY per un'app, il periodo di manutenzione viene ignorato per quell'app e viene aggiornato il prima possibile anche al di fuori del periodo di manutenzione.

POSTPONE Rimanda l'installazione automatica fino a un massimo di 30 giorni. Questo criterio non influisce sugli aggiornamenti della sicurezza (ad esempio le patch di sicurezza mensili).

FreezePeriod

Un periodo di blocco del sistema. Quando l'orologio di un dispositivo rientra nel periodo di blocco, tutti gli aggiornamenti di sistema in arrivo (incluse le patch di sicurezza) vengono bloccati e non verranno installati.

Quando il dispositivo è al di fuori di un periodo di blocco impostato, viene applicato il normale comportamento della norma (automatico, con finestra o posticipato).

Gli anni bisestili vengono ignorati nei calcoli del periodo di blocco, in particolare:

  • Se il 29 febbraio viene impostato come data di inizio o di fine di un periodo di blocco, questo inizierà o terminerà il 28 febbraio.
  • Quando l'orologio di sistema di un dispositivo indica 29 febbraio, l'orologio viene considerato come 28 febbraio.
  • Nel calcolare il numero di giorni che rientrano in un periodo di blocco o l'intervallo di tempo tra due periodi di blocco, il 29 febbraio viene ignorato e non conteggiato come un giorno.

Nota: affinché i periodi di blocco abbiano effetto, SystemUpdateType non può essere specificato come SYSTEM_UPDATE_TYPE_UNSPECIFIED, perché i periodi di blocco richiedono l'indicazione di un criterio definito.

Rappresentazione JSON
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Campi
startDate

object (Date)

La data di inizio (inclusa) del periodo di blocco. Nota: non è necessario impostare year. Ad esempio, {"month": 1,"date": 30}.

endDate

object (Date)

La data di fine (inclusa) del periodo di blocco. Non deve superare i 90 giorni dalla data di inizio. Se la data di fine è precedente a quella di inizio, il periodo di blocco viene considerato fine anno conclusivo. Nota: non è necessario impostare year. Ad esempio, {"month": 1,"date": 30}.

Data

Rappresenta una data di calendario intera o parziale, come un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può trattarsi di uno dei seguenti valori:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • Un mese e un giorno con zero anni (ad esempio, un anniversario).
  • Un anno a sé stante, con uno zero mese e uno zero-day.
  • Un anno e un mese, con zero day (ad esempio, la data di scadenza della carta di credito).

Tipi correlati:

Rappresentazione JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.

month

integer

Mese dell'anno. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.

day

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 e deve essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e mese in cui il giorno non è significativo.

StatusReportingSettings

Impostazioni che gestiscono il comportamento dei report di stato.

Rappresentazione JSON
{
  "applicationReportsEnabled": boolean,
  "deviceSettingsEnabled": boolean,
  "softwareInfoEnabled": boolean,
  "memoryInfoEnabled": boolean,
  "networkInfoEnabled": boolean,
  "displayInfoEnabled": boolean,
  "powerManagementEventsEnabled": boolean,
  "hardwareStatusEnabled": boolean,
  "systemPropertiesEnabled": boolean,
  "applicationReportingSettings": {
    object (ApplicationReportingSettings)
  },
  "commonCriteriaModeEnabled": boolean
}
Campi
applicationReportsEnabled

boolean

Se i report sulle app sono attivati.

deviceSettingsEnabled

boolean

Indica se i report sulle impostazioni del dispositivo sono attivati.

softwareInfoEnabled

boolean

Se i report sulle informazioni sul software sono abilitati.

memoryInfoEnabled

boolean

Indica se i report sugli eventi di memoria sono abilitati.

networkInfoEnabled

boolean

Indica se i report sulle informazioni sulla rete sono attivati.

displayInfoEnabled

boolean

Se i report mostra sono attivati. I dati dei report non sono disponibili per i dispositivi personali con profili di lavoro.

powerManagementEventsEnabled

boolean

Indica se i report sugli eventi di gestione dell'alimentazione sono abilitati. I dati dei report non sono disponibili per i dispositivi personali con profili di lavoro.

hardwareStatusEnabled

boolean

Indica se i report sullo stato dell'hardware sono attivati. I dati dei report non sono disponibili per i dispositivi personali con profili di lavoro.

systemPropertiesEnabled

boolean

Se la generazione di report sulle proprietà di sistema è abilitata.

applicationReportingSettings

object (ApplicationReportingSettings)

Impostazioni di reporting delle applicazioni. Applicabile solo se applicationReportEnabled è true.

commonCriteriaModeEnabled

boolean

Se i report su Common Criteria Mode sono attivati. Questa opzione è supportata solo sui dispositivi di proprietà dell'azienda.

ApplicationReportingSettings

Impostazioni che gestiscono il comportamento dei report delle applicazioni.

Rappresentazione JSON
{
  "includeRemovedApps": boolean
}
Campi
includeRemovedApps

boolean

Se le app rimosse sono incluse nei report sulle applicazioni.

PackageNameList

Un elenco di nomi di pacchetti.

Rappresentazione JSON
{
  "packageNames": [
    string
  ]
}
Campi
packageNames[]

string

Un elenco di nomi di pacchetti.

BatteryPluggedMode

Modalità per collegare la batteria.

Enum
BATTERY_PLUGGED_MODE_UNSPECIFIED Questo valore viene ignorato.
AC La fonte di alimentazione è un caricabatterie CA.
USB La fonte di alimentazione è una porta USB.
WIRELESS La fonte di alimentazione è wireless.

ProxyInfo

Informazioni sulla configurazione per un proxy HTTP. Per un proxy diretto, imposta i campi host, port e excludedHosts. Per un proxy script PAC, imposta il campo pacUri.

Rappresentazione JSON
{
  "host": string,
  "port": integer,
  "excludedHosts": [
    string
  ],
  "pacUri": string
}
Campi
host

string

L'host del proxy diretto.

port

integer

La porta del proxy diretto.

excludedHosts[]

string

Per un proxy diretto, si tratta degli host per i quali il proxy viene ignorato. I nomi host possono contenere caratteri jolly, ad esempio *.example.com.

pacUri

string

L'URI dello script PAC utilizzato per configurare il proxy.

ChoosePrivateKeyRule

Controlla le app l'accesso alle chiavi private. La regola determina quale chiave privata, se presente, Android Device Policy concede all'app specificata. L'accesso viene concesso quando l'app chiama KeyChain.choosePrivateKeyAlias (o qualsiasi sovraccarico) per richiedere un alias di chiave privata per un determinato URL o per le regole che non sono specifiche dell'URL (ovvero se urlPattern non è impostato o è impostato sulla stringa vuota o .*) su Android 11 e versioni successive, direttamente in modo che l'app possa chiamare KeyChain.getPrivateKey, senza dover prima chiamare KeyChain.choosePrivateKeyAlias.

Quando un'app chiama KeyChain.choosePrivateKeyAlias se più di un choosePrivateKeyRules corrisponde, l'ultima regola di corrispondenza definisce quale alias di chiave restituire.

Rappresentazione JSON
{
  "urlPattern": string,
  "packageNames": [
    string
  ],
  "privateKeyAlias": string
}
Campi
urlPattern

string

Il pattern URL da abbinare all'URL della richiesta. Se non viene configurato o se è vuoto, corrisponde a tutti gli URL. Viene utilizzata la sintassi delle espressioni regolari di java.util.regex.Pattern.

packageNames[]

string

I nomi dei pacchetti a cui si applica questa regola. L'hash del certificato di firma di ogni app viene verificato in base all'hash fornito da Play. Se non viene specificato alcun nome di pacchetto, l'alias viene fornito a tutte le app che chiamano KeyChain.choosePrivateKeyAlias o a eventuali sovraccarichi (ma non senza chiamare KeyChain.choosePrivateKeyAlias, anche su Android 11 e versioni successive). Qualsiasi app con lo stesso UID Android di un pacchetto specificato qui avrà accesso quando chiamerà KeyChain.choosePrivateKeyAlias.

privateKeyAlias

string

L'alias della chiave privata da utilizzare.

AlwaysOnVpnPackage

Configurazione per una connessione VPN sempre attiva.

Rappresentazione JSON
{
  "packageName": string,
  "lockdownEnabled": boolean
}
Campi
packageName

string

Il nome del pacchetto dell'app VPN.

lockdownEnabled

boolean

Non consente il networking quando la VPN non è connessa.

LocationMode

Il grado di rilevamento della posizione attivato sul profilo di lavoro e sui dispositivi completamente gestiti.

Enum
LOCATION_MODE_UNSPECIFIED Il valore predefinito è LOCATION_USER_CHOICE.
HIGH_ACCURACY

Su Android 8 e versioni precedenti, sono attivi tutti i metodi di rilevamento della posizione, inclusi GPS, reti e altri sensori. Su Android 9 e versioni successive, il valore equivale a LOCATION_ENFORCED.

SENSORS_ONLY

Su Android 8 e versioni precedenti, sono abilitati solo il GPS e altri sensori. Su Android 9 e versioni successive, il valore equivale a LOCATION_ENFORCED.

BATTERY_SAVING

Su Android 8 e versioni precedenti, è attivo solo il fornitore di servizi di geolocalizzazione della rete. Su Android 9 e versioni successive, il valore equivale a LOCATION_ENFORCED.

OFF

Su Android 8 e versioni precedenti, la Precisione e l'impostazione della geolocalizzazione sono disattivate. Su Android 9 e versioni successive, il valore equivale a LOCATION_DISABLED.

LOCATION_USER_CHOICE L'impostazione di geolocalizzazione non è limitata sul dispositivo. Non viene impostato né applicato alcun comportamento specifico.
LOCATION_ENFORCED Attiva l'impostazione di geolocalizzazione sul dispositivo.
LOCATION_DISABLED Disattiva l'impostazione di geolocalizzazione sul dispositivo.

ComplianceRule

Una regola che dichiara quali azioni mitiganti intraprendere quando un dispositivo non è conforme alle sue norme. Per ogni regola, esiste sempre un'azione di mitigazione implicita per impostare policyCompliant su false per la risorsa Device e visualizzare un messaggio sul dispositivo che indica che non è conforme alle relative norme. Facoltativamente, è possibile intraprendere anche altre azioni di mitigazione, a seconda dei valori dei campi nella regola.

Rappresentazione JSON
{
  "disableApps": boolean,
  "packageNamesToDisable": [
    string
  ],

  // Union field condition can be only one of the following:
  "nonComplianceDetailCondition": {
    object (NonComplianceDetailCondition)
  },
  "apiLevelCondition": {
    object (ApiLevelCondition)
  }
  // End of list of possible types for union field condition.
}
Campi
disableApps

boolean

Se viene impostata su true, la regola include un'azione di mitigazione per disattivare le app in modo che il dispositivo sia effettivamente disattivato, ma i dati dell'app vengono conservati. Se sul dispositivo è in esecuzione un'app in modalità di attività bloccata, l'app verrà chiusa e verrà visualizzata una UI che mostra il motivo della non conformità.

packageNamesToDisable[]

string

Se impostata, la regola include un'azione di mitigazione per disattivare le app specificate nell'elenco, ma i dati delle app vengono conservati.

Campo unione condition. La condizione, che, se soddisfatta, attiva le azioni di mitigazione definite nella regola. È necessario impostare esattamente una delle condizioni. condition può essere solo uno dei seguenti:
nonComplianceDetailCondition

object (NonComplianceDetailCondition)

Una condizione che viene soddisfatta se esiste una corrispondenza di NonComplianceDetail per il dispositivo.

apiLevelCondition

object (ApiLevelCondition)

Una condizione che viene soddisfatta se il livello API Android Framework sul dispositivo non soddisfa un requisito minimo.

NonComplianceDetailCondition

Una condizione della regola di conformità che è soddisfatta se esiste qualsiasi NonComplianceDetail corrispondente per il dispositivo. Un NonComplianceDetail corrisponde a un NonComplianceDetailCondition se tutti i campi impostati in NonComplianceDetailCondition corrispondono ai campi NonComplianceDetail corrispondenti.

Rappresentazione JSON
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string
}
Campi
settingName

string

Il nome dell'impostazione del criterio. Si tratta del nome di un campo Policy di primo livello. Se non viene impostata, questa condizione corrisponde a qualsiasi nome di impostazione.

nonComplianceReason

enum (NonComplianceReason)

Il motivo per cui il dispositivo non è conforme all'impostazione. Se non viene impostata, questa condizione corrisponde a qualsiasi motivo.

packageName

string

Il nome del pacchetto dell'app non conforme. Se non viene impostata, questa condizione corrisponde a qualsiasi nome di pacchetto.

ApiLevelCondition

Una condizione della regola di conformità che viene soddisfatta se il livello API Android Framework sul dispositivo non soddisfa un requisito minimo. Può esserci una sola regola con questo tipo di condizione per criterio.

Rappresentazione JSON
{
  "minApiLevel": integer
}
Campi
minApiLevel

integer

Il livello API Android Framework minimo desiderato. Se il dispositivo non soddisfa i requisiti minimi, questa condizione è soddisfatta. Deve essere maggiore di zero.

AppAutoUpdatePolicy

Alternativa consigliata: l'attributo autoUpdateMode, che viene impostato per singola app, offre una maggiore flessibilità per quanto riguarda la frequenza di aggiornamento.

Se autoUpdateMode viene impostato su AUTO_UPDATE_POSTPONED o AUTO_UPDATE_HIGH_PRIORITY, questo campo non ha alcun effetto.

Il criterio di aggiornamento automatico delle app, che consente di stabilire quando è possibile applicare gli aggiornamenti automatici delle app.

Enum
APP_AUTO_UPDATE_POLICY_UNSPECIFIED Il criterio di aggiornamento automatico non è impostato. Equivalente a CHOICE_TO_THE_USER.
CHOICE_TO_THE_USER L'utente può controllare gli aggiornamenti automatici.
NEVER Le app non vengono mai aggiornate automaticamente.
WIFI_ONLY Le app vengono aggiornate automaticamente solo tramite Wi-Fi.
ALWAYS Le app vengono aggiornate automaticamente in qualsiasi momento. Potrebbero essere applicati dei costi per i dati.

AppTrack

Un canale di rilascio dell'app Google Play.

Enum
APP_TRACK_UNSPECIFIED Questo valore viene ignorato.
PRODUCTION Il canale di produzione, che fornisce l'ultima release stabile.
BETA Il canale beta, che fornisce l'ultima release beta.

EncryptionPolicy

Tipo di crittografia

Enum
ENCRYPTION_POLICY_UNSPECIFIED Questo valore viene ignorato, ovvero non è richiesta alcuna crittografia
ENABLED_WITHOUT_PASSWORD Crittografia obbligatoria, ma senza password per l'avvio
ENABLED_WITH_PASSWORD Crittografia richiesta con password per l'avvio

PlayStoreMode

Valori possibili per il criterio della modalità Play Store.

Enum
PLAY_STORE_MODE_UNSPECIFIED Non specificato. Il valore predefinito è WHITELIST.
WHITELIST Sono disponibili solo le app che sono incluse nel criterio e quelle che non rientrano nel criterio verranno disinstallate automaticamente dal dispositivo.
BLACKLIST Tutte le app sono disponibili e quelle che non devono essere presenti sul dispositivo devono essere contrassegnate esplicitamente come "BLOCCATE" nel criterio applications.

SetupAction

Un'azione eseguita durante la configurazione.

Rappresentazione JSON
{
  "title": {
    object (UserFacingMessage)
  },
  "description": {
    object (UserFacingMessage)
  },

  // Union field action can be only one of the following:
  "launchApp": {
    object (LaunchAppAction)
  }
  // End of list of possible types for union field action.
}
Campi
title

object (UserFacingMessage)

Titolo di questa azione.

description

object (UserFacingMessage)

Descrizione di questa azione.

Campo unione action. L'azione da eseguire durante la configurazione. action può essere solo uno dei seguenti:
launchApp

object (LaunchAppAction)

Un'azione per avviare un'app. L'app verrà avviata con un intent contenente un extra con la chiave com.google.android.apps.work.clouddpc.EXTRA_LAUNCHED_AS_SETUP_ACTION impostata sul valore booleano true per indicare che si tratta di un flusso di azioni di configurazione. Se SetupAction fa riferimento a un'app, il valore installType corrispondente nei criteri dell'applicazione deve essere impostato su REQUIRED_FOR_SETUP, altrimenti la configurazione non andrà a buon fine.

LaunchAppAction

Un'azione per avviare un'app.

Rappresentazione JSON
{

  // Union field launch can be only one of the following:
  "packageName": string
  // End of list of possible types for union field launch.
}
Campi
Campo unione launch. La descrizione dell'azione di lancio da eseguire launch può essere solo una delle seguenti:
packageName

string

Nome pacchetto dell'app da avviare

PolicyEnforcementRule

Una regola che definisce le azioni da intraprendere se un dispositivo o un profilo di lavoro non è conforme al criterio specificato in settingName. Nel caso di più corrispondenze o di più regole di applicazione attivate, verrà eseguita un'unione con l'azione più grave. Tuttavia, tutte le regole attivate vengono comunque monitorate, inclusi il tempo di attivazione iniziale e tutti i dettagli associati alla mancata conformità. Nel caso in cui venga soddisfatta la regola di applicazione più grave, verrà applicata l'azione successiva più appropriata.

Rappresentazione JSON
{
  "blockAction": {
    object (BlockAction)
  },
  "wipeAction": {
    object (WipeAction)
  },

  // Union field trigger can be only one of the following:
  "settingName": string
  // End of list of possible types for union field trigger.
}
Campi
blockAction

object (BlockAction)

Un'azione per bloccare l'accesso ad app e dati su un dispositivo di proprietà dell'azienda o in un profilo di lavoro. Questa azione attiva anche una notifica rivolta agli utenti con informazioni (ove possibile) su come risolvere il problema di conformità. Nota: è necessario specificare anche wipeAction.

wipeAction

object (WipeAction)

Un'azione per reimpostare un dispositivo di proprietà dell'azienda o eliminare un profilo di lavoro. Nota: è necessario specificare anche blockAction.

Campo unione trigger. Condizione che attiva questa regola. trigger può essere solo uno dei seguenti:
settingName

string

Il criterio di primo livello da applicare. Ad esempio, applications o passwordPolicies.

BlockAction

Un'azione per bloccare l'accesso ad app e dati su un dispositivo completamente gestito o in un profilo di lavoro. Inoltre, questa azione fa sì che un dispositivo o un profilo di lavoro mostri una notifica rivolta agli utenti con informazioni (ove possibile) su come risolvere il problema di conformità. Nota: è necessario specificare anche wipeAction.

Rappresentazione JSON
{
  "blockAfterDays": integer,
  "blockScope": enum (BlockScope)
}
Campi
blockAfterDays

integer

Numero di giorni in cui il criterio non è conforme prima che il dispositivo o il profilo di lavoro vengano bloccati. Per bloccare immediatamente l'accesso, imposta il valore su 0. blockAfterDays deve essere inferiore a wipeAfterDays.

blockScope

enum (BlockScope)

Specifica l'ambito di questo BlockAction. Applicabile solo ai dispositivi di proprietà dell'azienda.

BlockScope

Specifica l'ambito di BlockAction. Applicabile solo ai dispositivi di proprietà dell'azienda.

Enum
BLOCK_SCOPE_UNSPECIFIED Non specificato. Il valore predefinito è BLOCK_SCOPE_WORK_PROFILE.
BLOCK_SCOPE_WORK_PROFILE L'azione di blocco viene applicata solo alle app nel profilo di lavoro. Le app nel profilo personale non sono interessate.
BLOCK_SCOPE_DEVICE L'azione di blocco viene applicata all'intero dispositivo, incluse le app nel profilo personale.

WipeAction

Un'azione per reimpostare un dispositivo di proprietà dell'azienda o eliminare un profilo di lavoro. Nota: è necessario specificare anche blockAction.

Rappresentazione JSON
{
  "wipeAfterDays": integer,
  "preserveFrp": boolean
}
Campi
wipeAfterDays

integer

Numero di giorni in cui il criterio non è conforme prima della cancellazione dei dati del dispositivo o del profilo di lavoro. wipeAfterDays deve essere maggiore di blockAfterDays.

preserveFrp

boolean

Indica se i dati della protezione ripristino dati di fabbrica vengono conservati sul dispositivo. Questa impostazione non si applica ai profili di lavoro.

KioskCustomization

Impostazioni che gestiscono il comportamento di un dispositivo in modalità kiosk. Per attivare la modalità kiosk, imposta kioskCustomLauncherEnabled su true o specifica un'app nel criterio con installType KIOSK.

Rappresentazione JSON
{
  "powerButtonActions": enum (PowerButtonActions),
  "systemErrorWarnings": enum (SystemErrorWarnings),
  "systemNavigation": enum (SystemNavigation),
  "statusBar": enum (StatusBar),
  "deviceSettings": enum (DeviceSettings)
}
Campi
powerButtonActions

enum (PowerButtonActions)

Consente di impostare il comportamento di un dispositivo in modalità kiosk quando un utente tiene premuto il tasto di accensione.

systemErrorWarnings

enum (SystemErrorWarnings)

Specifica se le finestre di dialogo degli errori di sistema per le app che hanno subito un arresto anomalo o che non rispondono sono bloccate in modalità kiosk. Quando è bloccato, il sistema forza l'interruzione dell'app come se l'utente scegliesse l'opzione "Chiudi app" sull'interfaccia utente.

systemNavigation

enum (SystemNavigation)

Specifica quali funzionalità di navigazione sono attivate (ad es. i pulsanti Home, Panoramica) in modalità kiosk.

statusBar

enum (StatusBar)

Specifica se le informazioni e le notifiche di sistema sono disabilitate in modalità kiosk.

deviceSettings

enum (DeviceSettings)

Specifica se l'app Impostazioni è consentita in modalità kiosk.

PowerButtonActions

Consente di impostare il comportamento di un dispositivo in modalità kiosk quando un utente tiene premuto il tasto di accensione.

Enum
POWER_BUTTON_ACTIONS_UNSPECIFIED Non specificato, il valore predefinito è POWER_BUTTON_AVAILABLE.
POWER_BUTTON_AVAILABLE Il menu del tasto di accensione (ad es. Spegni, Riavvia) viene mostrato quando un utente preme a lungo il tasto di accensione di un dispositivo in modalità kiosk.
POWER_BUTTON_BLOCKED Il menu del tasto di accensione (ad es. Spegni, Riavvio) non viene mostrato quando un utente preme a lungo il tasto di accensione di un dispositivo in modalità kiosk. Nota: questa operazione potrebbe impedire agli utenti di spegnere il dispositivo.

SystemErrorWarnings

Specifica se le finestre di dialogo degli errori di sistema per le app che hanno subito un arresto anomalo o che non rispondono sono bloccate in modalità kiosk.

Enum
SYSTEM_ERROR_WARNINGS_UNSPECIFIED Non specificato, il valore predefinito è ERROR_AND_WARNINGS_MUTED.
ERROR_AND_WARNINGS_ENABLED Vengono visualizzate tutte le finestre di dialogo degli errori di sistema, ad esempio l'arresto anomalo e l'app che non risponde (ANR).
ERROR_AND_WARNINGS_MUTED Tutte le finestre di dialogo degli errori di sistema, ad esempio l'arresto anomalo e l'app che non risponde (ANR), sono bloccate. Quando è bloccato, il sistema arresta forzatamente l'app come se l'utente la chiudesse dalla UI.

SystemNavigation

Specifica quali funzionalità di navigazione sono attivate (ad es. i pulsanti Home, Panoramica) in modalità kiosk.

Enum
SYSTEM_NAVIGATION_UNSPECIFIED Non specificato, il valore predefinito è NAVIGATION_DISABLED.
NAVIGATION_ENABLED I pulsanti Home e Panoramica sono attivi.
NAVIGATION_DISABLED I pulsanti Home e Panoramica non sono accessibili.
HOME_BUTTON_ONLY Viene attivato solo il pulsante Home.

StatusBar

Specifica se le informazioni e le notifiche di sistema sono disabilitate in modalità kiosk.

Enum
STATUS_BAR_UNSPECIFIED Non specificato, il valore predefinito è INFO_AND_NOTIFICATIONS_DISABLED.
NOTIFICATIONS_AND_SYSTEM_INFO_ENABLED

Le informazioni e le notifiche sul sistema vengono visualizzate nella barra di stato in modalità kiosk.

Nota:per applicare questo criterio, il pulsante Home del dispositivo deve essere attivato utilizzando kioskCustomization.systemNavigation.

NOTIFICATIONS_AND_SYSTEM_INFO_DISABLED Le informazioni e le notifiche sul sistema sono disattivate in modalità kiosk.
SYSTEM_INFO_ONLY Nella barra di stato vengono mostrate solo le informazioni sul sistema.

DeviceSettings

Specifica se un utente può accedere all'app Impostazioni del dispositivo in modalità kiosk.

Enum
DEVICE_SETTINGS_UNSPECIFIED Non specificato, il valore predefinito è SETTINGS_ACCESS_ALLOWED.
SETTINGS_ACCESS_ALLOWED L'accesso all'app Impostazioni è consentito in modalità kiosk.
SETTINGS_ACCESS_BLOCKED L'accesso all'app Impostazioni non è consentito in modalità kiosk.

AdvancedSecurityOverrides

Impostazioni di sicurezza avanzate. Nella maggior parte dei casi, non è necessario configurarli.

Rappresentazione JSON
{
  "untrustedAppsPolicy": enum (UntrustedAppsPolicy),
  "googlePlayProtectVerifyApps": enum (GooglePlayProtectVerifyApps),
  "developerSettings": enum (DeveloperSettings),
  "commonCriteriaMode": enum (CommonCriteriaMode),
  "personalAppsThatCanReadWorkNotifications": [
    string
  ],
  "mtePolicy": enum (MtePolicy)
}
Campi
untrustedAppsPolicy

enum (UntrustedAppsPolicy)

Il criterio per le app non attendibili (app di origini sconosciute) applicato al dispositivo. Sostituisce installUnknownSourcesAllowed (deprecated).

googlePlayProtectVerifyApps

enum (GooglePlayProtectVerifyApps)

Indica se è applicata la verifica di Google Play Protect. Sostituisce ensureVerifyAppsEnabled (deprecato).

developerSettings

enum (DeveloperSettings)

Consente di gestire l'accesso alle impostazioni sviluppatore: Opzioni sviluppatore e Avvio protetto. Sostituisce safeBootDisabled (deprecato) e debuggingFeaturesAllowed (deprecato).

commonCriteriaMode

enum (CommonCriteriaMode)

Consente di controllare la modalità Common Criteria: standard di sicurezza definiti nella pagina Common Criteria for Information Technology Security Evaluation (CC). L'attivazione della modalità Common Criteria aumenta alcuni componenti di sicurezza del dispositivo, tra cui la crittografia AES-GCM delle chiavi Bluetooth a lungo termine e gli archivi di configurazione Wi-Fi.

La modalità Common Criteria è supportata solo sui dispositivi di proprietà dell'azienda con Android 11 o versioni successive.

Avviso: la modalità Common Criteria applica un modello di sicurezza rigoroso, generalmente richiesto solo per i prodotti IT utilizzati nei sistemi di sicurezza nazionale e in altre organizzazioni altamente sensibili. Ciò potrebbe influire sull'utilizzo standard dei dispositivi. Attivato solo se richiesto.

personalAppsThatCanReadWorkNotifications[]

string

App personali in grado di leggere le notifiche del profilo di lavoro tramite NotificationListenerService. Per impostazione predefinita, nessuna app personale (a parte le app di sistema) può leggere le notifiche di lavoro. Ciascun valore nell'elenco deve essere il nome di un pacchetto.

mtePolicy

enum (MtePolicy)

(Facoltativo) Consente di controllare l'estensione per il tagging della memoria (MTE) sul dispositivo. Per applicare le modifiche al criterio MTE, è necessario riavviare il dispositivo.

UntrustedAppsPolicy

Il criterio per le app non attendibili (app di origini sconosciute) applicato al dispositivo. Sostituisce installUnknownSourcesAllowed (deprecated).

Enum
UNTRUSTED_APPS_POLICY_UNSPECIFIED Non specificato. Il valore predefinito è DISALLOW_INSTALL.
DISALLOW_INSTALL Predefinita. Non consentire installazioni di app non attendibili sull'intero dispositivo.
ALLOW_INSTALL_IN_PERSONAL_PROFILE_ONLY Per i dispositivi con profili di lavoro, consenti l'installazione di app non attendibili solo nel profilo personale del dispositivo.
ALLOW_INSTALL_DEVICE_WIDE Consenti installazioni di app non attendibili su tutto il dispositivo.

GooglePlayProtectVerifyApps

Indica se è applicata la verifica di Google Play Protect. Sostituisce ensureVerifyAppsEnabled (deprecato).

Enum
GOOGLE_PLAY_PROTECT_VERIFY_APPS_UNSPECIFIED Non specificato. Il valore predefinito è VERIFY_APPS_ENFORCED.
VERIFY_APPS_ENFORCED Predefinita. Consente di forzare l'attivazione della verifica app.
VERIFY_APPS_USER_CHOICE Consente all'utente di scegliere se attivare o meno la verifica app.

DeveloperSettings

Consente di gestire l'accesso alle impostazioni sviluppatore: Opzioni sviluppatore e Avvio protetto. Sostituisce safeBootDisabled (deprecato) e debuggingFeaturesAllowed (deprecato).

Enum
DEVELOPER_SETTINGS_UNSPECIFIED Non specificato. Il valore predefinito è DEVELOPER_SETTINGS_DISABLED.
DEVELOPER_SETTINGS_DISABLED Predefinita. Disattiva tutte le impostazioni sviluppatore e impedisce all'utente di accedervi.
DEVELOPER_SETTINGS_ALLOWED Consente tutte le impostazioni sviluppatore. L'utente può accedere alle impostazioni e, facoltativamente, configurarle.

CommonCriteriaMode

Consente di controllare la modalità Common Criteria: standard di sicurezza definiti nella pagina Common Criteria for Information Technology Security Evaluation (CC). L'attivazione della modalità Common Criteria aumenta alcuni componenti di sicurezza del dispositivo, tra cui la crittografia AES-GCM delle chiavi Bluetooth a lungo termine e gli archivi di configurazione Wi-Fi.

La modalità Common Criteria è supportata solo sui dispositivi di proprietà dell'azienda con Android 11 o versioni successive.

Avviso: la modalità Common Criteria applica un modello di sicurezza rigoroso, generalmente richiesto solo per i prodotti IT utilizzati nei sistemi di sicurezza nazionale e in altre organizzazioni altamente sensibili. Ciò potrebbe influire sull'utilizzo standard dei dispositivi. Attivato solo se richiesto. Se la modalità Common Criteria viene disattivata dopo essere stata abilitata in precedenza, tutte le reti Wi-Fi configurate dall'utente potrebbero andare perse e tutte le reti Wi-Fi configurate dall'azienda che richiedono un input utente potrebbero dover essere riconfigurate.

Enum
COMMON_CRITERIA_MODE_UNSPECIFIED Non specificato. Il valore predefinito è common_CRITERIA_MODE_DISABLED.
COMMON_CRITERIA_MODE_DISABLED Predefinita. Disattiva la modalità Common Criteria.
COMMON_CRITERIA_MODE_ENABLED Consente di attivare la modalità Common Criteria.

MtePolicy

Consente di controllare l'estensione per il tagging della memoria (MTE) sul dispositivo.

Enum
MTE_POLICY_UNSPECIFIED Non specificato. Il valore predefinito è MTE_USER_CHOICE.
MTE_USER_CHOICE L'utente può scegliere di attivare o disattivare la funzionalità MTE sul dispositivo se quest'ultimo supporta questa funzionalità.
MTE_ENFORCED

La funzionalità MTE è attivata sul dispositivo e l'utente non è autorizzato a modificare questa impostazione. Questa opzione può essere impostata su dispositivi completamente gestiti e profili di lavoro sui dispositivi di proprietà dell'azienda. Per altre modalità di gestione viene segnalato un nonComplianceDetail con MANAGEMENT_MODE. Se il dispositivo non supporta la funzionalità MTE, viene segnalato un nonComplianceDetail con DEVICE_INCOMPATIBLE.

Funzionalità supportata su Android 14 e versioni successive. Se la versione di Android è precedente alla 14, viene segnalato un nonComplianceDetail con API_LEVEL.

MTE_DISABLED

La funzionalità MTE è disattivata sul dispositivo e l'utente non è autorizzato a modificare questa impostazione. Si applica solo ai dispositivi completamente gestiti. In altri casi, viene segnalato nonComplianceDetail con MANAGEMENT_MODE. Se il dispositivo non supporta la funzionalità MTE, viene segnalato un nonComplianceDetail con DEVICE_INCOMPATIBLE.

Funzionalità supportata su Android 14 e versioni successive. Se la versione di Android è precedente alla 14, viene segnalato un nonComplianceDetail con API_LEVEL.

PersonalUsagePolicies

Criteri che controllano l'utilizzo personale su un dispositivo di proprietà dell'azienda con un profilo di lavoro.

Rappresentazione JSON
{
  "cameraDisabled": boolean,
  "screenCaptureDisabled": boolean,
  "accountTypesWithManagementDisabled": [
    string
  ],
  "maxDaysWithWorkOff": integer,
  "personalPlayStoreMode": enum (PlayStoreMode),
  "personalApplications": [
    {
      object (PersonalApplicationPolicy)
    }
  ]
}
Campi
cameraDisabled

boolean

Se impostato su true, la fotocamera è disattivata sul profilo personale.

screenCaptureDisabled

boolean

Se il valore è true, l'acquisizione schermo è disattivata per tutti gli utenti.

accountTypesWithManagementDisabled[]

string

Tipi di account che non possono essere gestiti dall'utente.

maxDaysWithWorkOff

integer

Controlla per quanto tempo il profilo di lavoro può rimanere disattivato. La durata minima deve essere di almeno 3 giorni. Gli altri dettagli sono riportati di seguito:

  • Se la durata è impostata su 0, la funzionalità viene disattivata.
  • Se la durata è impostata su un valore inferiore alla durata minima, la caratteristica restituisce un errore.
Nota: se vuoi evitare che i profili personali vengano sospesi durante lunghi periodi di inattività, puoi impostare temporaneamente un valore elevato per questo parametro.

personalPlayStoreMode

enum (PlayStoreMode)

Utilizzati insieme a personalApplications per controllare il modo in cui le app nel profilo personale vengono consentite o bloccate.

personalApplications[]

object (PersonalApplicationPolicy)

Criterio applicato alle applicazioni nel profilo personale.

PlayStoreMode

Utilizzati insieme a personalApplications per controllare il modo in cui le app nel profilo personale vengono consentite o bloccate.

Enum
PLAY_STORE_MODE_UNSPECIFIED Non specificato. Il valore predefinito è BLOCKLIST.
BLACKLIST

Tutte le app del Play Store possono essere installate nel profilo personale, ad eccezione di quelle il cui installType è BLOCKED in personalApplications.

BLOCKLIST Tutte le app del Play Store possono essere installate nel profilo personale, ad eccezione di quelle il cui installType è BLOCKED in personalApplications.
ALLOWLIST Solo le app esplicitamente specificate in personalApplications con installType impostato su AVAILABLE possono essere installate nel profilo personale.

PersonalApplicationPolicy

Criteri per le app nel profilo personale di un dispositivo di proprietà dell'azienda con un profilo di lavoro.

Rappresentazione JSON
{
  "packageName": string,
  "installType": enum (InstallType)
}
Campi
packageName

string

Il nome del pacchetto dell'applicazione.

installType

enum (InstallType)

Il tipo di installazione da eseguire.

InstallType

Tipi di comportamenti di installazione che possono avere un'applicazione con profilo personale.

Enum
INSTALL_TYPE_UNSPECIFIED Non specificato. Il valore predefinito è AVAILABLE.
BLOCKED L'app è bloccata e non può essere installata nel profilo personale. Se l'app era già stata installata nel dispositivo, verrà disinstallata.
AVAILABLE L'app può essere installata nel profilo personale.

AutoDateAndTimeZone

Indica se la data, l'ora e il fuso orario automatiche sono abilitati su un dispositivo di proprietà dell'azienda.

Enum
AUTO_DATE_AND_TIME_ZONE_UNSPECIFIED Non specificato. Il valore predefinito è AUTO_DATE_AND_TIME_ZONE_USER_CHOICE.
AUTO_DATE_AND_TIME_ZONE_USER_CHOICE Data, ora e fuso orario vengono lasciati a scelta dell'utente.
AUTO_DATE_AND_TIME_ZONE_ENFORCED Applica in modo forzato la data, l'ora e il fuso orario automatici sul dispositivo.

OncCertificateProvider

Questa funzionalità non è disponibile a livello generale.

Rappresentazione JSON
{
  "certificateReferences": [
    string
  ],

  // Union field endpoint can be only one of the following:
  "contentProviderEndpoint": {
    object (ContentProviderEndpoint)
  }
  // End of list of possible types for union field endpoint.
}
Campi
certificateReferences[]

string

Questa funzionalità non è disponibile a livello generale.

Campo unione endpoint.

Questa funzionalità non è disponibile a livello generale. endpoint può essere solo uno dei seguenti:

contentProviderEndpoint

object (ContentProviderEndpoint)

Questa funzionalità non è disponibile a livello generale.

ContentProviderEndpoint

Questa funzionalità non è disponibile a livello generale.

Rappresentazione JSON
{
  "uri": string,
  "packageName": string,
  "signingCertsSha256": [
    string
  ]
}
Campi
uri

string

Questa funzionalità non è disponibile a livello generale.

packageName

string

Questa funzionalità non è disponibile a livello generale.

signingCertsSha256[]

string

Obbligatorio. Questa funzionalità non è disponibile a livello generale.

CrossProfilePolicies

Controlla i dati del profilo di lavoro a cui è possibile accedere dal profilo personale e viceversa. Se il dispositivo non ha un profilo di lavoro, viene segnalato un nonComplianceDetail con MANAGEMENT_MODE.

Rappresentazione JSON
{
  "showWorkContactsInPersonalProfile": enum (ShowWorkContactsInPersonalProfile),
  "crossProfileCopyPaste": enum (CrossProfileCopyPaste),
  "crossProfileDataSharing": enum (CrossProfileDataSharing),
  "workProfileWidgetsDefault": enum (WorkProfileWidgetsDefault),
  "exemptionsToShowWorkContactsInPersonalProfile": {
    object (PackageNameList)
  }
}
Campi
showWorkContactsInPersonalProfile

enum (ShowWorkContactsInPersonalProfile)

Se le app personali possono accedere ai contatti memorizzati nel profilo di lavoro.

Vedi anche exemptionsToShowWorkContactsInPersonalProfile.

crossProfileCopyPaste

enum (CrossProfileCopyPaste)

Indica se il testo copiato da un profilo (personale o di lavoro) può essere incollato nell'altro profilo.

crossProfileDataSharing

enum (CrossProfileDataSharing)

Indica se i dati di un profilo (personale o di lavoro) possono essere condivisi con app nell'altro profilo. In particolare, controlla la semplice condivisione di dati tramite gli intent. Gestione di altri canali di comunicazione tra profili, come la ricerca di contatti, il copia/incolla o il lavoro collegato e app personali, sono configurate separatamente.

workProfileWidgetsDefault

enum (WorkProfileWidgetsDefault)

Specifica il comportamento predefinito per i widget del profilo di lavoro. Se il criterio non specifica workProfileWidgets per un'applicazione specifica, si comporterà in base al valore specificato qui.

exemptionsToShowWorkContactsInPersonalProfile

object (PackageNameList)

Elenco di app escluse dall'impostazione ShowWorkContactsInPersonalProfile. Per poter essere impostato, ShowWorkContactsInPersonalProfile deve essere impostato su uno dei seguenti valori:

Funzionalità supportata su Android 14 e versioni successive. Se la versione di Android è precedente alla 14, viene segnalato un nonComplianceDetail con API_LEVEL.

ShowWorkContactsInPersonalProfile

Se le app personali possono accedere ai contatti del profilo di lavoro, incluse le ricerche di contatti e le chiamate in arrivo

Nota: una volta che un'app personale accede a un contatto di lavoro, non è possibile garantire che rimanga nella stessa app, poiché il contatto potrebbe essere condiviso o trasferito a qualsiasi altra app, a seconda del comportamento di quest'ultima.

Enum
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_UNSPECIFIED

Non specificato. Il valore predefinito è SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED.

Se questo criterio è impostato, exemptionsToShowWorkContactsInPersonalProfile non deve essere impostato.

SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED

Impedisce alle app personali di accedere ai contatti del profilo di lavoro e di cercare i contatti di lavoro.

Se questa impostazione è attiva, le app personali specificate in exemptionsToShowWorkContactsInPersonalProfile sono inserite nella lista consentita e possono accedere direttamente ai contatti del profilo di lavoro.

Funzionalità supportata su Android 7.0 e versioni successive. Se la versione di Android è precedente alla 7.0, viene segnalato un nonComplianceDetail con API_LEVEL.

SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED

Predefinita. Consente alle app nel profilo personale di accedere ai contatti del profilo di lavoro, incluse le ricerche di contatti e le chiamate in arrivo.

Se questa impostazione è attiva, le app personali specificate in exemptionsToShowWorkContactsInPersonalProfile vengono inserite nella lista bloccata e non possono accedere direttamente ai contatti del profilo di lavoro.

Funzionalità supportata su Android 7.0 e versioni successive. Se la versione di Android è precedente alla 7.0, viene segnalato un nonComplianceDetail con API_LEVEL.

SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM

Impedisce alla maggior parte delle app personali di accedere ai contatti del profilo di lavoro, incluse le ricerche dei contatti e le chiamate in arrivo, ad eccezione delle app Telefono, Messaggi e Contatti predefiniti del produttore. Né le app Telefono, Messaggi e Contatti configurate dall'utente né altre app di sistema o di riproduzione installate potranno inviare query direttamente ai contatti di lavoro.

Se questa impostazione è attiva, le app personali specificate in exemptionsToShowWorkContactsInPersonalProfile sono inserite nella lista consentita e possono accedere ai contatti del profilo di lavoro.

Funzionalità supportata su Android 14 e versioni successive. Se questa impostazione è impostata su un dispositivo con versione di Android precedente alla 14, il comportamento torna a SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED e viene segnalato un nonComplianceDetail con API_LEVEL.

CrossProfileCopyPaste

Indica se il testo copiato da un profilo (personale o di lavoro) può essere incollato nell'altro profilo.

Enum
CROSS_PROFILE_COPY_PASTE_UNSPECIFIED Non specificato. Il valore predefinito è COPY_FROM_WORK_TO_PERSONAL_DISALLOWED
COPY_FROM_WORK_TO_PERSONAL_DISALLOWED Predefinita. Impedisce agli utenti di incollare nel testo del profilo personale copiato dal profilo di lavoro. Il testo copiato dal profilo personale può essere incollato nel profilo di lavoro, mentre il testo copiato dal profilo di lavoro può essere incollato in quest'ultimo.
CROSS_PROFILE_COPY_PASTE_ALLOWED Il testo copiato in uno dei profili può essere incollato nell'altro.

CrossProfileDataSharing

Indica se i dati di un profilo (personale o di lavoro) possono essere condivisi con app nell'altro profilo. In particolare, controlla la semplice condivisione di dati tramite gli intent. Gestione di altri canali di comunicazione tra profili, come la ricerca di contatti, il copia/incolla o il lavoro collegato e app personali, sono configurate separatamente.

Enum
CROSS_PROFILE_DATA_SHARING_UNSPECIFIED Non specificato. Il valore predefinito è DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED.
CROSS_PROFILE_DATA_SHARING_DISALLOWED Impedisce la condivisione dei dati del profilo personale con il profilo di lavoro e del profilo di lavoro con il profilo personale.
DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED Predefinita. Impedisce agli utenti di condividere i dati del profilo di lavoro con le app del profilo personale. I dati personali possono essere condivisi con le app di lavoro.
CROSS_PROFILE_DATA_SHARING_ALLOWED I dati di uno dei due profili possono essere condivisi con l'altro.

WorkProfileWidgetsDefault

Consente di stabilire se le applicazioni del profilo di lavoro possono aggiungere widget alla schermata Home, dove non è definito un criterio specifico dell'app. In caso contrario, le norme specifiche dell'app avranno la priorità.

Enum
WORK_PROFILE_WIDGETS_DEFAULT_UNSPECIFIED Non specificato. Il valore predefinito è WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED.
WORK_PROFILE_WIDGETS_DEFAULT_ALLOWED I widget del profilo di lavoro sono consentiti per impostazione predefinita. Ciò significa che se il criterio non specifica workProfileWidgets come WORK_PROFILE_WIDGETS_DISALLOWED per l'applicazione, quest'ultima potrà aggiungere widget alla schermata Home.
WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED I widget del profilo di lavoro non sono consentiti per impostazione predefinita. Ciò significa che se il criterio non specifica workProfileWidgets come WORK_PROFILE_WIDGETS_ALLOWED per l'applicazione, l'applicazione non potrà aggiungere widget alla schermata Home.

PreferentialNetworkService

Consente di controllare se il servizio di rete preferenziale è abilitato sul profilo di lavoro. Per ulteriori dettagli, consulta preferentialNetworkService.

Enum
PREFERENTIAL_NETWORK_SERVICE_UNSPECIFIED Non specificato. Il valore predefinito è PREFERENTIAL_NETWORK_SERVICES_DISABLED.
PREFERENTIAL_NETWORK_SERVICE_DISABLED Il servizio di rete preferito è disattivato sul profilo di lavoro.
PREFERENTIAL_NETWORK_SERVICE_ENABLED Il servizio di rete preferito è abilitato sul profilo di lavoro.

UsageLog

Consente di controllare i tipi di log delle attività del dispositivo raccolti dal dispositivo e segnalati tramite notifica Pub/Sub.

Rappresentazione JSON
{
  "enabledLogTypes": [
    enum (LogType)
  ],
  "uploadOnCellularAllowed": [
    enum (LogType)
  ]
}
Campi
enabledLogTypes[]

enum (LogType)

Specifica i tipi di log da attivare. Tieni presente che gli utenti riceveranno messaggi sul dispositivo quando la registrazione dell'utilizzo è attiva.

uploadOnCellularAllowed[]

enum (LogType)

Specifica quali tipi di log attivati possono essere caricati tramite dati mobili. Per impostazione predefinita, i log vengono messi in coda per il caricamento quando il dispositivo si connette alla rete Wi-Fi.

LogType

I tipi di log delle attività del dispositivo segnalati dal dispositivo.

Enum
LOG_TYPE_UNSPECIFIED Questo valore non è utilizzato.
SECURITY_LOGS Attiva il logging degli eventi di sicurezza on-device, ad esempio in caso di inserimento errato della password del dispositivo o memoria rimovibile montata. Consulta UsageLogEvent per una descrizione completa degli eventi di sicurezza registrati. Impostazione supportata per i dispositivi completamente gestiti su Android 7 e versioni successive. Funzionalità supportata per i dispositivi di proprietà dell'azienda con un profilo di lavoro su Android 12 e versioni successive, su cui vengono registrati solo gli eventi di sicurezza del profilo di lavoro. Può essere sostituito dall'ambito delegato dell'applicazione SECURITY_LOGS
NETWORK_ACTIVITY_LOGS Attiva il logging degli eventi di rete sul dispositivo, come ricerche DNS e connessioni TCP. Consulta UsageLogEvent per una descrizione completa degli eventi di rete registrati. Funzionalità supportata per i dispositivi completamente gestiti su Android 8 e versioni successive. Funzionalità supportata per i dispositivi di proprietà dell'azienda con un profilo di lavoro su Android 12 e versioni successive, su cui vengono registrati solo gli eventi di rete del profilo di lavoro. Può essere sostituito dall'ambito delegato dell'applicazione NETWORK_ACTIVITY_LOGS

CameraAccess

Controlla l'utilizzo della fotocamera e se l'utente ha accesso all'opzione di attivazione/disattivazione dell'accesso alla fotocamera. L'opzione di attivazione/disattivazione dell'accesso alla fotocamera è disponibile su Android 12 e versioni successive. In linea di principio, la possibilità di disattivare la videocamera si applica a livello di dispositivo sui dispositivi completamente gestiti e solo all'interno del profilo di lavoro sui dispositivi con un profilo di lavoro. La possibilità di disattivare l'opzione di accesso alla fotocamera si applica solo ai dispositivi completamente gestiti, nel qual caso viene applicata a livello di dispositivo. Per informazioni specifiche, consulta i valori enum.

Enum
CAMERA_ACCESS_UNSPECIFIED Se cameraDisabled è vero, equivale a CAMERA_ACCESS_DISABLED. In caso contrario, equivale a CAMERA_ACCESS_USER_CHOICE.
CAMERA_ACCESS_USER_CHOICE Il campo cameraDisabled viene ignorato. Questo è il comportamento predefinito del dispositivo: sono disponibili tutte le fotocamere del dispositivo. Su Android 12 e versioni successive, l'utente può utilizzare il pulsante di accesso alla fotocamera.
CAMERA_ACCESS_DISABLED

Il campo cameraDisabled viene ignorato. Tutte le videocamere sul dispositivo sono disattivate (per i dispositivi completamente gestiti si applica a livello di dispositivo, mentre per i profili di lavoro si applica solo al profilo di lavoro).

Non sono presenti limitazioni esplicite per l'attivazione/disattivazione dell'accesso alla fotocamera su Android 12 e versioni successive: sui dispositivi completamente gestiti, l'opzione di attivazione/disattivazione dell'accesso alla fotocamera non ha alcun effetto, in quanto tutte le fotocamere sono disattivate. Sui dispositivi con un profilo di lavoro, questa opzione di attivazione/disattivazione non ha alcun effetto sulle app nel profilo di lavoro, ma interessa le app esterne al profilo.

CAMERA_ACCESS_ENFORCED Il campo cameraDisabled viene ignorato. Tutte le fotocamere del dispositivo sono disponibili. Sui dispositivi completamente gestiti con Android 12 e versioni successive, l'utente non può utilizzare il pulsante di accesso alla fotocamera. Sui dispositivi non completamente gestiti o con Android 11 o versioni precedenti, il valore equivale a CAMERA_ACCESS_USER_CHOICE.

MicrophoneAccess

Sui dispositivi completamente gestiti, consente di controllare l'utilizzo del microfono e se l'utente ha accesso o meno all'opzione di attivazione/disattivazione del microfono. Questa impostazione non ha alcun effetto sui dispositivi non completamente gestiti. L'opzione di attivazione/disattivazione dell'accesso al microfono è disponibile su Android 12 e versioni successive.

Enum
MICROPHONE_ACCESS_UNSPECIFIED Se unmuteMicrophoneDisabled è vero, equivale a MICROPHONE_ACCESS_DISABLED. In caso contrario, equivale a MICROPHONE_ACCESS_USER_CHOICE.
MICROPHONE_ACCESS_USER_CHOICE Il campo unmuteMicrophoneDisabled viene ignorato. Questo è il comportamento predefinito del dispositivo: il microfono sul dispositivo è disponibile. Su Android 12 e versioni successive, l'utente può utilizzare l'opzione di attivazione/disattivazione dell'accesso al microfono.
MICROPHONE_ACCESS_DISABLED

Il campo unmuteMicrophoneDisabled viene ignorato. Il microfono sul dispositivo è disattivato (per i dispositivi completamente gestiti, questo vale a livello di dispositivo).

L'opzione di accesso al microfono non ha alcun effetto perché il microfono è disattivato.

MICROPHONE_ACCESS_ENFORCED Il campo unmuteMicrophoneDisabled viene ignorato. Il microfono sul dispositivo sia disponibile. Sui dispositivi con Android 12 e versioni successive, l'utente non può utilizzare il pulsante di attivazione/disattivazione dell'accesso al microfono. Sui dispositivi con Android 11 o versioni precedenti, equivale a MICROPHONE_ACCESS_USER_CHOICE.

DeviceConnectivityManagement

Include i controlli per la connettività dei dispositivi, ad esempio Wi-Fi, accesso ai dati USB, connessioni tastiera/mouse e altro ancora.

Rappresentazione JSON
{
  "usbDataAccess": enum (UsbDataAccess),
  "configureWifi": enum (ConfigureWifi),
  "wifiDirectSettings": enum (WifiDirectSettings),
  "tetheringSettings": enum (TetheringSettings),
  "wifiSsidPolicy": {
    object (WifiSsidPolicy)
  }
}
Campi
usbDataAccess

enum (UsbDataAccess)

Consente di controllare quali file e/o dati possono essere trasferiti tramite USB. Funzionalità supportata solo sui dispositivi di proprietà dell'azienda.

configureWifi

enum (ConfigureWifi)

Consente di controllare i privilegi di configurazione della rete Wi-Fi. In base all'opzione impostata, l'utente avrà il controllo completo, limitato o nullo della configurazione delle reti Wi-Fi.

wifiDirectSettings

enum (WifiDirectSettings)

Consente di controllare la configurazione e l'utilizzo delle impostazioni Wi-Fi Direct. Funzionalità supportata sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive.

tetheringSettings

enum (TetheringSettings)

Consente di gestire le impostazioni relative al tethering. In base al valore impostato, all'utente non è consentito, in parte o del tutto, utilizzare diverse forme di tethering.

wifiSsidPolicy

object (WifiSsidPolicy)

Restrizioni relative agli SSID Wi-Fi a cui il dispositivo può connettersi. Tieni presente che ciò non influisce sulle reti che possono essere configurate sul dispositivo. Funzionalità supportata sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive.

UsbDataAccess

Consente di controllare quali file e/o dati possono essere trasferiti tramite USB. Non influisce sulle funzioni di ricarica. Funzionalità supportata solo sui dispositivi di proprietà dell'azienda.

Enum
USB_DATA_ACCESS_UNSPECIFIED Non specificato. Il valore predefinito è DISALLOW_USB_FILE_TRANSFER.
ALLOW_USB_DATA_TRANSFER Sono consentiti tutti i tipi di trasferimenti di dati tramite USB. usbFileTransferDisabled viene ignorato.
DISALLOW_USB_FILE_TRANSFER Il trasferimento di file tramite USB non è consentito. Sono consentiti altri tipi di connessioni dati USB, ad esempio il collegamento con mouse e tastiera. usbFileTransferDisabled viene ignorato.
DISALLOW_USB_DATA_TRANSFER Quando questa impostazione è impostata, sono vietati tutti i tipi di trasferimenti di dati USB. Funzionalità supportata per dispositivi con Android 12 o versioni successive con USB HAL 1.3 o versioni successive. Se l'impostazione non è supportata, verrà configurato DISALLOW_USB_FILE_TRANSFER. Se la versione di Android è precedente alla 12, viene segnalato un nonComplianceDetail con API_LEVEL. Se il dispositivo non dispone di USB HAL 1.3 o versioni successive, viene segnalato un nonComplianceDetail con DEVICE_INCOMPATIBLE. usbFileTransferDisabled viene ignorato.

ConfigureWifi

Consente di controllare i privilegi di configurazione della rete Wi-Fi. In base all'opzione impostata, l'utente avrà il controllo completo, limitato o nullo della configurazione delle reti Wi-Fi.

Enum
CONFIGURE_WIFI_UNSPECIFIED Non specificato. Il valore predefinito è ALLOW_CONFIGURING_WIFI, a meno che wifiConfigDisabled non sia impostato su true. Se wifiConfigDisabled è impostato su true, equivale a DISALLOW_CONFIGURING_WIFI.
ALLOW_CONFIGURING_WIFI L'utente può configurare il Wi-Fi. wifiConfigDisabled viene ignorato.
DISALLOW_ADD_WIFI_CONFIG L'aggiunta di nuove configurazioni Wi-Fi non è consentita. L'utente può passare solo da una rete già configurata all'altra. Funzionalità supportata su Android 13 e versioni successive, sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda. Se l'impostazione non è supportata, viene configurato ALLOW_CONFIGURING_WIFI. Se la versione di Android è precedente alla 13, viene segnalato un nonComplianceDetail con API_LEVEL. wifiConfigDisabled viene ignorato.
DISALLOW_CONFIGURING_WIFI Non consente la configurazione di reti Wi-Fi. L'impostazione wifiConfigDisabled viene ignorata quando questo valore viene impostato. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda, su tutti i livelli API supportati. Per i dispositivi completamente gestiti, l'impostazione rimuove tutte le reti configurate e conserva solo quelle configurate utilizzando il criterio openNetworkConfiguration. Per i profili di lavoro sui dispositivi di proprietà dell'azienda, le reti configurate esistenti non sono interessate e all'utente non è consentito aggiungere, rimuovere o modificare le reti Wi-Fi. Nota:se non è possibile stabilire una connessione di rete al momento dell'avvio e la configurazione della rete Wi-Fi è disattivata, viene visualizzata l'opzione di escape hatch di rete per aggiornare i criteri relativi ai dispositivi (vedi networkEscapeHatchEnabled).

WifiDirectSettings

Consente di controllare le impostazioni di Wi-Fi Direct. Funzionalità supportata sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive.

Enum
WIFI_DIRECT_SETTINGS_UNSPECIFIED Non specificato. Il valore predefinito è ALLOW_WIFI_DIRECT
ALLOW_WIFI_DIRECT L'utente può utilizzare Wi-Fi Direct.
DISALLOW_WIFI_DIRECT L'utente non è autorizzato a utilizzare Wi-Fi Direct. Se la versione di Android è precedente alla 13, viene segnalato un nonComplianceDetail con API_LEVEL.

TetheringSettings

Consente di controllare in che misura l'utente può utilizzare diverse forme di tethering, ad esempio tethering Wi-Fi, Bluetooth e così via.

Enum
TETHERING_SETTINGS_UNSPECIFIED Non specificato. Il valore predefinito è ALLOW_ALL_TETHERING, a meno che tetheringConfigDisabled non sia impostato su true. Se tetheringConfigDisabled è impostato su true, equivale a DISALLOW_ALL_TETHERING.
ALLOW_ALL_TETHERING Consente la configurazione e l'utilizzo di tutte le forme di tethering. tetheringConfigDisabled viene ignorato.
DISALLOW_WIFI_TETHERING Non consente all'utente di utilizzare il tethering Wi-Fi. Funzionalità supportata sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive. Se l'impostazione non è supportata, verrà configurato ALLOW_ALL_TETHERING. Se la versione di Android è precedente alla 13, viene segnalato un nonComplianceDetail con API_LEVEL. tetheringConfigDisabled viene ignorato.
DISALLOW_ALL_TETHERING Non consente tutte le forme di tethering. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda, su tutte le versioni di Android supportate. L'impostazione tetheringConfigDisabled viene ignorata.

WifiSsidPolicy

Restrizioni relative agli SSID Wi-Fi a cui il dispositivo può connettersi. Tieni presente che ciò non influisce sulle reti che possono essere configurate sul dispositivo. Funzionalità supportata sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive.

Rappresentazione JSON
{
  "wifiSsidPolicyType": enum (WifiSsidPolicyType),
  "wifiSsids": [
    {
      object (WifiSsid)
    }
  ]
}
Campi
wifiSsidPolicyType

enum (WifiSsidPolicyType)

Tipo di criterio SSID Wi-Fi da applicare.

wifiSsids[]

object (WifiSsid)

(Facoltativo) Elenco di SSID Wi-Fi che devono essere applicati al criterio. Questo campo non deve essere vuoto quando WifiSsidPolicyType è impostato su WIFI_SSID_ALLOWLIST. Se questo criterio viene impostato su un elenco non vuoto, viene segnalato un dettaglio nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13, mentre per i dispositivi non di proprietà dell'azienda viene segnalato un nonComplianceDetail con MANAGEMENT_MODE.

WifiSsidPolicyType

I tipi di criteri SSID della rete Wi-Fi che possono essere applicati al dispositivo.

Enum
WIFI_SSID_POLICY_TYPE_UNSPECIFIED Il valore predefinito è WIFI_SSID_DENYLIST. wifiSsids non deve essere impostato. Non ci sono limitazioni sul SSID a cui il dispositivo può connettersi.
WIFI_SSID_DENYLIST Il dispositivo non può connettersi a nessuna rete Wi-Fi il cui SSID è in wifiSsids, ma può connettersi ad altre reti.
WIFI_SSID_ALLOWLIST Il dispositivo può stabilire connessioni Wi-Fi solo agli SSID in wifiSsids. Il campo wifiSsids non deve essere vuoto. Il dispositivo non potrà connettersi a nessun'altra rete Wi-Fi.

WifiSsid

Rappresenta un SSID della rete Wi-Fi.

Rappresentazione JSON
{
  "wifiSsid": string
}
Campi
wifiSsid

string

Obbligatorio. SSID Wi-Fi rappresentato da una stringa.

DeviceRadioState

Controlli per le impostazioni del segnale radio dei dispositivi.

Rappresentazione JSON
{
  "wifiState": enum (WifiState),
  "airplaneModeState": enum (AirplaneModeState),
  "ultraWidebandState": enum (UltraWidebandState),
  "cellularTwoGState": enum (CellularTwoGState),
  "minimumWifiSecurityLevel": enum (MinimumWifiSecurityLevel)
}
Campi
wifiState

enum (WifiState)

Consente di controllare lo stato attuale della rete Wi-Fi e se l'utente può modificarne lo stato.

airplaneModeState

enum (AirplaneModeState)

Consente di stabilire se l'utente può attivare o disattivare la modalità aereo.

ultraWidebandState

enum (UltraWidebandState)

Consente di controllare lo stato dell'impostazione della banda ultralarga e se l'utente può attivarla o disattivarla.

cellularTwoGState

enum (CellularTwoGState)

Consente di stabilire se l'utente può attivare o disattivare l'impostazione della rete mobile 2G.

minimumWifiSecurityLevel

enum (MinimumWifiSecurityLevel)

Il livello di sicurezza minimo richiesto per le reti Wi-Fi a cui il dispositivo può connettersi.

WifiState

Consente di stabilire se il Wi-Fi è attivo o meno come stato e se l'utente può modificare tale stato. Funzionalità supportata sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive.

Enum
WIFI_STATE_UNSPECIFIED Non specificato. Il valore predefinito è WIFI_STATE_USER_CHOICE
WIFI_STATE_USER_CHOICE L'utente può attivare/disattivare il Wi-Fi.
WIFI_ENABLED Il Wi-Fi è attivo e l'utente non è autorizzato a disattivarlo. Se la versione di Android è precedente alla 13, viene segnalato un nonComplianceDetail con API_LEVEL.
WIFI_DISABLED Il Wi-Fi è disattivato e l'utente non è autorizzato ad attivarlo. Se la versione di Android è precedente alla 13, viene segnalato un nonComplianceDetail con API_LEVEL.

AirplaneModeState

Consente di controllare lo stato della modalità aereo e se l'utente può attivarla o disattivarla. Funzionalità supportata su Android 9 e versioni successive. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda.

Enum
AIRPLANE_MODE_STATE_UNSPECIFIED Non specificato. Il valore predefinito è AIRPLANE_MODE_USER_CHOICE.
AIRPLANE_MODE_USER_CHOICE L'utente può attivare o disattivare la modalità aereo.
AIRPLANE_MODE_DISABLED La modalità aereo è disattivata. L'utente non è autorizzato ad attivare la modalità aereo. Se la versione di Android è precedente alla 9, viene segnalato un nonComplianceDetail con API_LEVEL.

UltraWidebandState

Consente di controllare lo stato dell'impostazione della banda ultralarga e se l'utente può attivarla o disattivarla. Funzionalità supportata su Android 14 e versioni successive. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda.

Enum
ULTRA_WIDEBAND_STATE_UNSPECIFIED Non specificato. Il valore predefinito è ULTRA_WIDEBAND_USER_CHOICE.
ULTRA_WIDEBAND_USER_CHOICE L'utente può attivare o disattivare la banda ultralarga.
ULTRA_WIDEBAND_DISABLED Banda ultralarga disattivata. All'utente non è consentito attivare la banda ultralarga tramite le impostazioni. Se la versione di Android è precedente alla 14, viene segnalato un nonComplianceDetail con API_LEVEL.

CellularTwoGState

Consente di controllare lo stato dell'impostazione della rete mobile 2G e se l'utente può attivarla o disattivarla. Funzionalità supportata su Android 14 e versioni successive. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda.

Enum
CELLULAR_TWO_G_STATE_UNSPECIFIED Non specificato. Il valore predefinito è CELLULAR_TWO_G_USER_CHOICE.
CELLULAR_TWO_G_USER_CHOICE L'utente può attivare o disattivare la rete mobile 2G.
CELLULAR_TWO_G_DISABLED La rete mobile 2G è disattivata. L'utente non è autorizzato ad attivare la rete mobile 2G tramite le impostazioni. Se la versione di Android è precedente alla 14, viene segnalato un nonComplianceDetail con API_LEVEL.

MinimumWifiSecurityLevel

Definisce i diversi livelli minimi di sicurezza Wi-Fi richiesti per connettersi alle reti Wi-Fi. Funzionalità supportata su Android 13 e versioni successive. Funzionalità supportata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda.

Enum
MINIMUM_WIFI_SECURITY_LEVEL_UNSPECIFIED Il valore predefinito è OPEN_NETWORK_SECURITY, quindi il dispositivo potrà connettersi a tutti i tipi di reti Wi-Fi.
OPEN_NETWORK_SECURITY Il dispositivo potrà connettersi a tutti i tipi di reti Wi-Fi.
PERSONAL_NETWORK_SECURITY Una rete personale come WEP o WPA2-PSK rappresenta il livello di sicurezza minimo richiesto. Il dispositivo non sarà in grado di connettersi a reti Wi-Fi aperte. Questo valore è più restrittivo di OPEN_NETWORK_SECURITY. Se la versione di Android è precedente alla 13, viene segnalato un nonComplianceDetail con API_LEVEL.
ENTERPRISE_NETWORK_SECURITY Il livello di sicurezza minimo richiesto è una rete EAP aziendale. Il dispositivo non potrà connettersi alla rete Wi-Fi al di sotto di questo livello di sicurezza. Questo valore è più restrittivo di PERSONAL_NETWORK_SECURITY. Se la versione di Android è precedente alla 13, viene segnalato un nonComplianceDetail con API_LEVEL.
ENTERPRISE_BIT192_NETWORK_SECURITY Una rete aziendale a 192 bit è il livello di sicurezza minimo richiesto. Il dispositivo non potrà connettersi alla rete Wi-Fi al di sotto di questo livello di sicurezza. Questo valore è più restrittivo di ENTERPRISE_NETWORK_SECURITY. Se la versione di Android è precedente alla 13, viene segnalato un nonComplianceDetail con API_LEVEL.

CredentialProviderPolicyDefault

Consente di stabilire quali app possono fungere da fornitori di credenziali su Android 14 e versioni successive. Queste app memorizzano le credenziali. Per informazioni dettagliate, vedi questo e questo. Vedi anche credentialProviderPolicy.

Enum
CREDENTIAL_PROVIDER_POLICY_DEFAULT_UNSPECIFIED Non specificato. Il valore predefinito è CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED.
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED Le app con credentialProviderPolicy non specificate non possono agire come fornitore di credenziali.
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED_EXCEPT_SYSTEM Le app per cui non è specificato il criterio credentialProviderPolicy non possono agire come fornitore di credenziali, ad eccezione dei fornitori di credenziali predefiniti OEM. I fornitori di credenziali predefiniti OEM sono sempre autorizzati a agire come fornitori di credenziali.

PrintingPolicy

Consente di stabilire se la stampa è consentita. Questa opzione è supportata sui dispositivi con Android 9 e versioni successive.

Enum
PRINTING_POLICY_UNSPECIFIED Non specificato. Il valore predefinito è PRINTING_ALLOWED.
PRINTING_DISALLOWED La stampa non è consentita. Se la versione di Android è precedente alla 9, viene segnalato un nonComplianceDetail con API_LEVEL.
PRINTING_ALLOWED La stampa è consentita.

DisplaySettings

Controlli per le impostazioni di visualizzazione.

Rappresentazione JSON
{
  "screenBrightnessSettings": {
    object (ScreenBrightnessSettings)
  },
  "screenTimeoutSettings": {
    object (ScreenTimeoutSettings)
  }
}
Campi
screenBrightnessSettings

object (ScreenBrightnessSettings)

(Facoltativo) Consente di controllare le impostazioni della luminosità dello schermo.

screenTimeoutSettings

object (ScreenTimeoutSettings)

(Facoltativo) Consente di controllare le impostazioni di spegnimento dello schermo.

ScreenBrightnessSettings

Controlli per le impostazioni della luminosità dello schermo.

Rappresentazione JSON
{
  "screenBrightnessMode": enum (ScreenBrightnessMode),
  "screenBrightness": integer
}
Campi
screenBrightnessMode

enum (ScreenBrightnessMode)

(Facoltativo) Consente di controllare la modalità di luminosità dello schermo.

screenBrightness

integer

(Facoltativo) La luminosità dello schermo è compresa tra 1 e 255, dove 1 è la più bassa e 255 è la luminosità massima. Il valore 0 (predefinito) indica che non è impostata alcuna luminosità dello schermo. Qualsiasi altro valore viene rifiutato. Per impostarlo, screenBrightnessMode deve essere BRIGHTNESS_AUTOMATIC o BRIGHTNESS_FIXED. Funzionalità supportata su Android 9 e versioni successive su dispositivi completamente gestiti. Se la versione di Android è precedente alla 9, viene segnalato un NonComplianceDetail con API_LEVEL.

ScreenBrightnessMode

Consente di controllare la modalità di luminosità dello schermo.

Enum
SCREEN_BRIGHTNESS_MODE_UNSPECIFIED Non specificato. Il valore predefinito è BRIGHTNESS_USER_CHOICE.
BRIGHTNESS_USER_CHOICE L'utente può configurare la luminosità dello schermo. screenBrightness non deve essere impostato.
BRIGHTNESS_AUTOMATIC La modalità di luminosità dello schermo è automatica in cui la luminosità viene regolata automaticamente e all'utente non è consentito configurare la luminosità dello schermo. È comunque possibile impostare screenBrightness, che viene preso in considerazione durante la regolazione automatica della luminosità. Funzionalità supportata su Android 9 e versioni successive su dispositivi completamente gestiti. Se la versione di Android è precedente alla 9, viene segnalato un NonComplianceDetail con API_LEVEL.
BRIGHTNESS_FIXED La modalità di luminosità dello schermo è fissa in cui la luminosità è impostata su screenBrightness e all'utente non è consentito configurare la luminosità dello schermo. È necessario impostare screenBrightness. Funzionalità supportata su Android 9 e versioni successive su dispositivi completamente gestiti. Se la versione di Android è precedente alla 9, viene segnalato un NonComplianceDetail con API_LEVEL.

ScreenTimeoutSettings

Consente di controllare le impostazioni di spegnimento dello schermo.

Rappresentazione JSON
{
  "screenTimeoutMode": enum (ScreenTimeoutMode),
  "screenTimeout": string
}
Campi
screenTimeoutMode

enum (ScreenTimeoutMode)

(Facoltativo) Consente di stabilire se all'utente è consentito configurare lo spegnimento dello schermo.

screenTimeout

string (Duration format)

(Facoltativo) Consente di controllare la durata dello spegnimento dello schermo. La durata dello spegnimento dello schermo deve essere maggiore di 0, altrimenti viene rifiutata. Inoltre, non deve essere superiore a maximumTimeToLock, altrimenti il timeout dello schermo è impostato su maximumTimeToLock e viene segnalato un NonComplianceDetail con motivo INVALID_VALUE e SCREEN_TIMEOUT_GREATER_THAN_MAXIMUM_TIME_TO_LOCK motivo specifico. Se lo spegnimento dello schermo è inferiore a un determinato limite inferiore, viene impostato sul limite inferiore. Il limite inferiore può variare da un dispositivo all'altro. Se questo criterio è impostato, screenTimeoutMode deve essere SCREEN_TIMEOUT_ENFORCED. Funzionalità supportata su Android 9 e versioni successive su dispositivi completamente gestiti. Se la versione di Android è precedente alla 9, viene segnalato un NonComplianceDetail con API_LEVEL.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

ScreenTimeoutMode

Consente di stabilire se all'utente è consentito configurare lo spegnimento dello schermo.

Enum
SCREEN_TIMEOUT_MODE_UNSPECIFIED Non specificato. Il valore predefinito è SCREEN_TIMEOUT_USER_CHOICE.
SCREEN_TIMEOUT_USER_CHOICE L'utente è autorizzato a configurare lo spegnimento dello schermo. screenTimeout non deve essere impostato.
SCREEN_TIMEOUT_ENFORCED Lo spegnimento dello schermo è impostato su screenTimeout e l'utente non è autorizzato a configurarlo. È necessario impostare screenTimeout. Funzionalità supportata su Android 9 e versioni successive su dispositivi completamente gestiti. Se la versione di Android è precedente alla 9, viene segnalato un NonComplianceDetail con API_LEVEL.

Metodi

delete

Elimina un criterio.

get

Recupera un criterio.

list

Elenca i criteri per una determinata azienda.

patch

Aggiorna o crea un criterio.