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 al suo interno.

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)
  },
  "assistContentPolicy": enum (AssistContentPolicy)
}
Campi
name

string

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

version

string (int64 format)

La versione del criterio. Questo è un 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. Un valore pari a 0 indica che non sono previste limitazioni.

screenCaptureDisabled

boolean

Indica se l'acquisizione dello schermo è disattivata.

cameraDisabled
(deprecated)

boolean

Se cameraAccess viene impostato su un valore diverso da CAMERA_ACCESS_UNSPECIFIED, questo non ha alcun effetto. In caso contrario, questo campo controlla se le videocamere sono disattivate: se il valore è 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 al di fuori del profilo di lavoro non è interessato.

keyguardDisabledFeatures[]

enum (KeyguardDisabledFeature)

Personalizzazioni del blocco 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à di gestore degli intent predefiniti.

openNetworkConfiguration

object (Struct format)

Configurazione di rete per il dispositivo. Per ulteriori informazioni, consulta Configurare le reti.

systemUpdate

object (SystemUpdate)

Il criterio di aggiornamento del 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 del Play Store.

Nota:gli aggiornamenti di sistema Google Play (chiamati anche aggiornamenti Mainline) vengono scaricati automaticamente e richiedono il riavvio del dispositivo per essere installati. Per ulteriori dettagli, consulta la sezione relativa al canale principale 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 è disattivata. Per i dispositivi in cui managementMode è DEVICE_OWNER, questo campo viene ignorato e l'utente non è mai autorizzato ad aggiungere o rimuovere utenti.

adjustVolumeDisabled

boolean

Indica se la regolazione del volume principale è disattivata. 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 di app da parte dell'utente è disattivata.

mountPhysicalMediaDisabled

boolean

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

modifyAccountsDisabled

boolean

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

safeBootDisabled
(deprecated)

boolean

Indica se il riavvio del dispositivo in avvio sicuro è disabilitato.

uninstallAppsDisabled

boolean

Indica se la disinstallazione delle applicazioni da parte dell'utente è disattivata. In questo modo, le app non vengono disinstallate, nemmeno quelle rimosse utilizzando applications

statusBarDisabled
(deprecated)

boolean

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

keyguardDisabled

boolean

Se il valore è true, la schermata di blocco viene disattivata per i display principali e/o secondari. Questo criterio è supportato solo nella modalità di gestione dei dispositivi dedicata.

minimumApiLevel

integer

Il livello API Android minimo consentito.

statusReportingSettings

object (StatusReportingSettings)

Impostazioni dei report sullo stato

bluetoothContactSharingDisabled

boolean

Indica se la condivisione dei contatti tramite Bluetooth è disattivata.

shortSupportMessage

object (UserFacingMessage)

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

longSupportMessage

object (UserFacingMessage)

Un messaggio mostrato all'utente nella schermata delle impostazioni degli amministratori 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. unifiedLockSettings non può essere utilizzato qui.

wifiConfigsLockdownEnabled
(deprecated)

boolean

Questa opzione è deprecata.

bluetoothConfigDisabled

boolean

Indica se la configurazione del Bluetooth è disabilitata.

cellBroadcastsConfigDisabled

boolean

Indica se la configurazione del cell broadcast è disabilitata.

credentialsConfigDisabled

boolean

Indica se la configurazione delle credenziali utente è disabilitata.

mobileNetworksConfigDisabled

boolean

Indica se la configurazione delle reti mobili è disabilitata.

tetheringConfigDisabled
(deprecated)

boolean

Indica se la configurazione del tethering e degli hotspot portatili è disabilitata. Se tetheringSettings è 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 delle reti Wi-Fi è disabilitata. Supportato sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda. Per i dispositivi completamente gestiti, l'impostazione 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 l'utente non è autorizzato ad aggiungere, rimuovere o modificare le reti Wi-Fi. Se configureWifi è impostato su un valore diverso da CONFIGURE_WIFI_UNSPECIFIED, questa impostazione viene ignorata. Nota: se non è possibile stabilire una connessione di rete all'avvio e la configurazione del Wi-Fi è disattivata, viene visualizzata la finestra di fuga di rete per aggiornare i criteri del dispositivo (vedi networkEscapeHatchEnabled).

createWindowsDisabled

boolean

Indica se la creazione di finestre diverse dalle finestre dell'app è disattivata.

networkResetDisabled

boolean

Indica se la reimpostazione delle impostazioni di rete è disattivata.

outgoingBeamDisabled

boolean

Indica se l'utilizzo della tecnologia NFC per trasmettere dati dalle app è disabilitato.

outgoingCallsDisabled

boolean

Indica se le chiamate in uscita sono disattivate.

removeUserDisabled

boolean

Indica se la rimozione di altri utenti è disattivata.

shareLocationDisabled

boolean

Indica se la condivisione della posizione è disattivata. shareLocationDisabled è supportato 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, questo non ha alcun effetto. In caso contrario, questo campo controlla se i microfoni sono disattivati: se il valore è true, tutti i microfoni sono disattivati, altrimenti sono disponibili. Questa funzionalità è 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 dell'app è attivata forzatamente.

permittedInputMethods

object (PackageNameList)

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

stayOnPluggedModes[]

enum (BatteryPluggedMode)

Le modalità con la batteria collegata per le quali il dispositivo rimane acceso. Quando utilizzi questa impostazione, ti consigliamo di cancellare maximumTimeToLock in modo che il dispositivo non si blocchi mentre rimane acceso.

recommendedGlobalProxy

object (ProxyInfo)

Il proxy HTTP globale indipendente dalla rete. In genere, i proxy devono essere configurati per rete in openNetworkConfiguration. Tuttavia, per configurazioni insolite come il filtro interno generale, potrebbe essere utile un proxy HTTP globale. Se il proxy non è accessibile, l'accesso alla rete potrebbe essere interrotto. Il proxy globale è solo un consiglio e alcune app potrebbero ignorarlo.

setUserIconDisabled

boolean

Indica se la modifica dell'icona utente è disabilitata.

setWallpaperDisabled

boolean

Indica se la modifica dello sfondo è disabilitata.

choosePrivateKeyRules[]

object (ChoosePrivateKeyRule)

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

alwaysOnVpnPackage

object (AlwaysOnVpnPackage)

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

frpAdminEmails[]

string

Indirizzi email degli amministratori dei dispositivi per la protezione ripristino dati di fabbrica. Quando il dispositivo viene ripristinato ai dati di fabbrica, sarà necessario che uno di questi amministratori acceda con l'indirizzo email e la password dell'Account Google per sbloccarlo. Se non vengono specificati amministratori, il dispositivo non fornirà la protezione del ripristino dei 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 roaming dei dati sono disattivati.

locationMode

enum (LocationMode)

Il grado di rilevamento della posizione abilitato.

networkEscapeHatchEnabled

boolean

Indica se la via di fuga di rete è attivata. Se non è possibile effettuare una connessione di rete all'avvio, la via di fuga chiede all'utente di connettersi temporaneamente a una rete per aggiornare i criteri del dispositivo. Dopo l'applicazione del criterio, la rete temporanea verrà dimenticata e il dispositivo continuerà l'avvio. In questo modo, non sarà possibile connettersi a una rete se non è presente una rete adatta nell'ultimo criterio e il dispositivo si avvia in un'app in modalità di blocco delle attività oppure se l'utente non è in grado di raggiungere le impostazioni del dispositivo.

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

bluetoothDisabled

boolean

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

complianceRules[]
(deprecated)

object (ComplianceRule)

Regole che dichiarano quali azioni di mitigazione intraprendere quando un dispositivo non è conforme ai suoi criteri. Quando le condizioni di più regole sono soddisfatte, vengono intraprese tutte le azioni di mitigazione per le regole. È previsto un limite massimo di 100 regole. Utilizza invece le regole di applicazione dei criteri.

blockApplicationsEnabled
(deprecated)

boolean

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

installUnknownSourcesAllowed
(deprecated)

boolean

Questo campo non ha alcun effetto.

debuggingFeaturesAllowed
(deprecated)

boolean

Indica se l'utente è autorizzato ad attivare le funzionalità di debug.

funDisabled

boolean

Indica se l'utente è autorizzato a divertirsi. Consente di stabilire se il minigioco Easter egg nelle Impostazioni è disattivato.

autoTimeRequired
(deprecated)

boolean

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

permittedAccessibilityServices

object (PackageNameList)

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

appAutoUpdatePolicy

enum (AppAutoUpdatePolicy)

Alternativa consigliata: autoUpdateMode, impostato per app, offre una maggiore flessibilità in termini di frequenza di aggiornamento.

Quando autoUpdateMode è impostato su AUTO_UPDATE_POSTPONED o AUTO_UPDATE_HIGH_PRIORITY, questo campo non ha effetto.

Le norme sugli aggiornamenti automatici delle app, che controllano quando è possibile applicare gli aggiornamenti automatici delle app.

kioskCustomLauncherEnabled

boolean

Indica se l'avvio app personalizzato del kiosk è abilitato. La schermata Home viene sostituita da un Avvio applicazioni che blocca il dispositivo sulle app installate tramite l'impostazione applications. Le app vengono 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

Indica se saltare i suggerimenti al primo utilizzo. L'amministratore di Enterprise può attivare il consiglio di sistema per le app di saltare il tutorial per l'utente e altri suggerimenti introduttivi alla prima esecuzione.

privateKeySelectionEnabled

boolean

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

encryptionPolicy

enum (EncryptionPolicy)

Indica se la crittografia è attivata

usbMassStorageEnabled
(deprecated)

boolean

Indica se l'archivio USB è attivo. Deprecato.

permissionGrants[]

object (PermissionGrant)

Autorizzazioni esplicite o concessioni o rifiuti di gruppo per tutte le app. Questi valori sostituiscono defaultPermissionPolicy.

playStoreMode

enum (PlayStoreMode)

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

setupActions[]

object (SetupAction)

Azione da eseguire durante la procedura di configurazione. È possibile specificare al massimo un'azione.

passwordPolicies[]

object (PasswordRequirements)

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

policyEnforcementRules[]

object (PolicyEnforcementRule)

Regole che definiscono il comportamento quando non è possibile applicare un determinato criterio sul dispositivo

kioskCustomization

object (KioskCustomization)

Impostazioni che controllano 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 impostarli.

personalUsagePolicies

object (PersonalUsagePolicies)

Criteri per la gestione dell'utilizzo personale su un dispositivo di proprietà dell'azienda.

autoDateAndTimeZone

enum (AutoDateAndTimeZone)

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

oncCertificateProviders[]

object (OncCertificateProvider)

Questa funzionalità non è disponibile a livello generale.

crossProfilePolicies

object (CrossProfilePolicies)

Criteri tra profili applicati sul dispositivo.

preferentialNetworkService

enum (PreferentialNetworkService)

Controlla se il servizio di rete preferenziale è attivo nel profilo di lavoro. Ad esempio, un'organizzazione potrebbe avere un contratto con un operatore per l'invio di tutti i dati di lavoro dei dispositivi dei dipendenti tramite un servizio di rete dedicato all'uso aziendale. Un esempio di servizio di rete preferito supportato è lo slice 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'uso della fotocamera e se l'utente ha accesso al pulsante di attivazione/disattivazione dell'accesso alla fotocamera.

microphoneAccess

enum (MicrophoneAccess)

Controlla l'uso del microfono e se l'utente ha accesso al pulsante di attivazione/disattivazione dell'accesso al microfono. Questo vale solo per i dispositivi completamente gestiti.

deviceConnectivityManagement

object (DeviceConnectivityManagement)

Riguarda 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 radio, come Wi-Fi, Bluetooth e altro ancora.

credentialProviderPolicyDefault

enum (CredentialProviderPolicyDefault)

Controlla quali app sono autorizzate ad agire come fornitori di credenziali su Android 14 e versioni successive. Queste app memorizzano le credenziali. Per maggiori dettagli, consulta questa e questa pagina. Vedi anche credentialProviderPolicy.

printingPolicy

enum (PrintingPolicy)

Facoltativo. Controlla se la stampa è consentita. Questa funzionalità è supportata sui dispositivi con Android 9 e versioni successive. .

displaySettings

object (DisplaySettings)

Facoltativo. Controlli per le impostazioni di visualizzazione.

assistContentPolicy

enum (AssistContentPolicy)

Facoltativo. Controlla se è consentito inviare AssistContent a un'app privilegiata, ad esempio un'app di assistenza. AssistContent include screenshot e informazioni su un'app, ad esempio il nome del pacchetto. Questa funzionalità è supportata su Android 15 e versioni successive.

ApplicationPolicy

Criterio per una singola app. Nota: la disponibilità delle applicazioni 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 è autorizzata a bloccarsi in modalità a schermo intero. OBSOLETO. Utilizza 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 valore defaultPermissionPolicy a livello di criterio che si applica a tutte le app. Non sostituisce permissionGrants, che si applica a tutte le app.

permissionGrants[]

object (PermissionGrant)

Concessioni o rifiuti di autorizzazioni esplicite per l'app. Questi valori sostituiscono 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. Ogni nome di campo nella configurazione gestita deve corrispondere al campo key del ManagedProperty. Il valore del campo deve essere compatibile con l'type del ManagedProperty:

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

disabled

boolean

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

minimumVersionCode

integer

La versione minima dell'app in esecuzione 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 NonComplianceDetail con nonComplianceReason impostato su APP_NOT_UPDATED. L'app deve essere già pubblicata su Google Play con un codice di versione maggiore o uguale a questo valore. Al massimo 20 app possono specificare un codice di versione minima per criterio.

delegatedScopes[]

enum (DelegatedScope)

Gli ambiti delegati all'app da Android Device Policy. Forniscono 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 degli ID traccia 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 solo al canale di produzione dell'app. Ulteriori dettagli su ogni canale sono disponibili in AppTrackInfo.

connectedWorkAndPersonalApp

enum (ConnectedWorkAndPersonalApp)

Controlla se l'app può comunicare con se stessa tra i profili di lavoro e personale di un dispositivo, in base al consenso dell'utente.

autoUpdateMode

enum (AutoUpdateMode)

Controlla 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 l'app è autorizzata a utilizzare la rete quando la VPN non è connessa e alwaysOnVpnPackage.lockdownEnabled è attivato. Se impostato su VPN_LOCKDOWN_ENFORCED, l'app non è autorizzata a utilizzare la rete e, se impostato su VPN_LOCKDOWN_EXEMPTION, l'app è autorizzata a utilizzare la rete. Supportato solo su dispositivi con Android 10 e versioni successive. Se questa operazione non è supportata dal dispositivo, il dispositivo conterrà un NonComplianceDetail con nonComplianceReason impostato su API_LEVEL e un campo path. Se questo non è applicabile all'app, il dispositivo conterrà un NonComplianceDetail con nonComplianceReason impostato su UNSUPPORTED e un fieldPath. 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 è autorizzata ad 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 un InstallConstraint. Più vincoli vengono rifiutati.

installPriority

integer

Facoltativo. Tra le app con installType impostato su:

Questo valore controlla la priorità relativa dell'installazione. Un valore pari a 0 (predefinito) indica che questa app non ha priorità rispetto alle altre app. Per i valori compresi tra 1 e 10.000, un valore più basso indica una priorità più elevata. I valori al di fuori dell'intervallo compreso tra 0 e 10.000 vengono rifiutati.

userControlSettings

enum (UserControlSettings)

Facoltativo. Specifica se il controllo dell'utente è consentito per l'app. Il controllo dell'utente include azioni come l'interruzione forzata e l'eliminazione dei dati dell'app. Supportato su Android 11 e versioni successive.

InstallType

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

Enum
INSTALL_TYPE_UNSPECIFIED Non specificato. Il valore predefinito è DISPONIBILE.
PREINSTALLED L'app viene installata automaticamente e può essere rimossa dall'utente.
FORCE_INSTALLED L'app viene installata automaticamente indipendentemente da una finestra di manutenzione impostata 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. Viene bloccata anche la funzionalità di app istantanea.
AVAILABLE L'app è disponibile per l'installazione.
REQUIRED_FOR_SETUP L'app viene installata automaticamente e non può essere rimossa dall'utente. Inoltre, impedisce il completamento della configurazione fino al termine dell'installazione.
KIOSK L'app viene installata automaticamente in modalità kiosk: è impostata come intent home preferito e inserita nella lista consentita per la modalità di attività della serratura. La configurazione del dispositivo non verrà completata finché l'app non sarà installata. Dopo l'installazione, gli utenti non potranno rimuovere l'app. Puoi impostare questo valore installType solo per un'app per criterio. Se questo valore è presente nel criterio, la barra di stato verrà disattivata automaticamente.

PermissionPolicy

Il criterio per le richieste di concessione delle autorizzazioni delle app.

Enum
PERMISSION_POLICY_UNSPECIFIED Norme non specificate. Se per un'autorizzazione non viene specificato alcun criterio ad alcun livello, viene usato per impostazione predefinita il comportamento PROMPT.
PROMPT Chiedi all'utente di concedere un'autorizzazione.
GRANT

Viene concessa automaticamente un'autorizzazione.

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

DENY Rifiutare automaticamente un'autorizzazione.

PermissionGrant

Configurazione di un'autorizzazione Android e del relativo stato di concessione.

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

string

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

policy

enum (PermissionPolicy)

Il criterio per la concessione dell'autorizzazione.

DelegatedScope

Ambiti di delega che un altro pacchetto può acquisire da Android Device Policy. Forniscono privilegi aggiuntivi per le applicazioni a cui vengono applicati.

Enum
DELEGATED_SCOPE_UNSPECIFIED Nessun ambito di delega specificato.
CERT_INSTALL Concede l'accesso all'installazione e alla gestione dei certificati. Questo ambito può essere delegato a più applicazioni.
MANAGED_CONFIGURATIONS Concede l'accesso alla gestione delle configurazioni gestite. Questo ambito può essere delegato a più applicazioni.
BLOCK_UNINSTALL Concede l'accesso per bloccare la disinstallazione. Questo ambito può essere delegato a più applicazioni.
PERMISSION_GRANT Concede l'accesso ai criteri di autorizzazione e allo stato di concessione delle autorizzazioni. Questo ambito può essere delegato a più applicazioni.
PACKAGE_ACCESS Concede l'accesso allo stato di accesso al pacchetto. Questo ambito può essere delegato a più applicazioni.
ENABLE_SYSTEM_APP Concede l'accesso per l'attivazione delle app di sistema. Questo ambito può essere delegato a più applicazioni.
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 a un massimo di un'applicazione. Supportato per i dispositivi completamente gestiti su Android 10 e versioni successive. Supportato per un profilo di lavoro su Android 12 e versioni successive. Quando la delega è supportata e impostata, 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 a un massimo di un'applicazione. Supportato per i dispositivi completamente gestiti e i dispositivi di proprietà dell'azienda con un profilo di lavoro su Android 12 e versioni successive. Quando la delega è supportata e impostata, SECURITY_LOGS viene ignorato.
CERT_SELECTION Concede l'accesso alla selezione dei certificati KeyChain per conto delle app che effettuano la richiesta. Una volta concessa, l'applicazione delegata inizierà a ricevere DelegatedAdminReceiver#onChoosePrivateKeyAlias. Consente all'applicazione delegata di chiamare i metodi grantKeyPairToApp e revokeKeyPairFromApp. Questo ambito può essere delegato a un massimo di un'applicazione. choosePrivateKeyRules deve essere vuoto e privateKeySelectionEnabled non ha alcun effetto se la selezione del certificato è 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 le variabili di configurazione <key, value> definite per la configurazione.

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

ConnectedWorkAndPersonalApp

Controlla se l'app può comunicare con se stessa tra 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

Controlla la modalità di aggiornamento automatico dell'app. Se un utente del dispositivo apporta modifiche alle impostazioni del dispositivo manualmente, queste scelte vengono ignorate da AutoUpdateMode in quanto hanno 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 priorità bassa per ridurre al minimo l'impatto sull'utente.

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

  • Il dispositivo non è in uso.
  • Il dispositivo è connesso a una rete senza misurazione.
  • Il dispositivo è in carica.
  • L'app da aggiornare non è in esecuzione in primo piano.

Il dispositivo riceve una notifica di un nuovo aggiornamento entro 24 ore dalla pubblicazione da parte dello sviluppatore, dopodiché 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 diventa obsoleta.

90 giorni dopo che l'app diventa obsoleta, viene installata automaticamente la versione più recente disponibile con priorità bassa (vedi AUTO_UPDATE_DEFAULT). In seguito all'aggiornamento, l'app viene aggiornata di nuovo automaticamente una volta trascorsi 90 giorni da quando torna a essere 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. Non vengono applicati vincoli.

Il dispositivo riceve una notifica il prima possibile quando un nuovo aggiornamento diventa disponibile.

NOTA:gli aggiornamenti delle app con implementazioni più grandi nell'ecosistema Android possono richiedere fino a 24 ore.

ExtensionConfig

Configurazione per attivare un'app come app di estensione, con la possibilità di interagire con Android Device Policy offline. Per le versioni di Android 11 e successive, le app di estensione sono esenti dalle limitazioni della batteria, pertanto non verranno inserite nel bucket App Standby con limitazioni. Le app di estensione sono protette anche da utenti che cancellano i dati o chiudono forzatamente l'applicazione, anche se gli amministratori possono continuare a utilizzare clear app data command nelle app di estensione, se necessario, per Android 11 e versioni successive.

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

string

Hash SHA-256 esadecimale codificato del certificato di firma dell'app di estensione. Sono valide solo le rappresentazioni di stringhe esadecimali di 64 caratteri.

Se non specificato, la firma per il nome del pacchetto corrispondente viene ottenuta dal Play Store.

Se questo elenco è vuoto, la firma dell'app di 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 di estensione sul dispositivo deve corrispondere a una delle voci in questo elenco affinché l'app possa comunicare con Android Device Policy.

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

notificationReceiver

string

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

AlwaysOnVpnLockdownExemption

Controlla 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

Controlla se un'applicazione del profilo di lavoro è autorizzata ad 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 impostato su:

che definisce un insieme di limitazioni per l'installazione dell'app. È necessario impostare almeno uno dei campi. Quando sono impostati più campi, è necessario che tutti i vincoli siano soddisfatti per l'installazione dell'app.

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. Limite di ricarica.

deviceIdleConstraint

enum (DeviceIdleConstraint)

Facoltativo. Limitazione 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, rete mobile e così via).
INSTALL_ONLY_ON_UNMETERED_NETWORK Qualsiasi rete non a consumo (ad es. Wi-Fi).

ChargingConstraint

Limite di ricarica.

Enum
CHARGING_CONSTRAINT_UNSPECIFIED Non specificato. Il valore predefinito è CHARGING_NOT_REQUIRED.
CHARGING_NOT_REQUIRED Il dispositivo non deve essere in carica.
INSTALL_ONLY_WHEN_CHARGING Il dispositivo deve essere in carica.

DeviceIdleConstraint

Limitazione dello stato di inattività del dispositivo.

Enum
DEVICE_IDLE_CONSTRAINT_UNSPECIFIED Non specificato. Il valore predefinito è DEVICE_IDLE_NOT_REQUIRED.
DEVICE_IDLE_NOT_REQUIRED Il dispositivo non deve essere 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 come l'interruzione forzata e l'eliminazione dei dati delle app. Supportato su Android 11 e versioni successive. Se per un'app è impostato extensionConfig, il controllo utente non è consentito, indipendentemente dal valore impostato. Per le app kiosk, USER_CONTROL_ALLOWED può essere utilizzato per consentire il controllo dell'utente.

Enum
USER_CONTROL_SETTINGS_UNSPECIFIED Utilizza il comportamento predefinito dell'app per determinare se il controllo dell'utente è consentito o meno. 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 critiche, il controllo utente non è consentito.
USER_CONTROL_ALLOWED Il controllo dell'utente è consentito per l'app. Le app kiosk possono utilizzarlo per consentire il controllo dell'utente.
USER_CONTROL_DISALLOWED Il controllo dell'utente non è consentito per l'app. API_LEVEL viene segnalato se la versione di Android è precedente alla 11.

KeyguardDisabledFeature

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

Enum
KEYGUARD_DISABLED_FEATURE_UNSPECIFIED Questo valore viene ignorato.
CAMERA Disattiva la fotocamera nelle schermate di protezione con password (ad es. PIN).
NOTIFICATIONS Disattiva la visualizzazione di tutte le notifiche nelle schermate della schermata di blocco protetta.
UNREDACTED_NOTIFICATIONS Disattiva le notifiche non oscurate nelle schermate della schermata di blocco protetta.
TRUST_AGENTS Ignora lo stato dell'agente di attendibilità nelle schermate di keyguard sicure.
DISABLE_FINGERPRINT Disattiva il sensore di impronte digitali nelle schermate della schermata di blocco sicura.
DISABLE_REMOTE_INPUT Sui dispositivi con Android 6 e versioni precedenti, disattiva l'inserimento di testo nelle notifiche nelle schermate di keyguard sicure. Non ha alcun effetto su Android 7 e versioni successive.
FACE Disattivare l'autenticazione volti nelle schermate della schermata di blocco protetta.
IRIS Disattiva l'autenticazione tramite l'iride nelle schermate di blocco sicure.
BIOMETRICS Disattivare tutta l'autenticazione biometrica nelle schermate della schermata di blocco sicura.
SHORTCUTS Disattivare tutte le scorciatoie nella schermata della schermata di blocco sicura su Android 14 e versioni successive.
ALL_FEATURES Disattivare tutte le personalizzazioni del blocco tastiera correnti e future.

PersistentPreferredActivity

Un'attività predefinita per la gestione degli intent corrispondenti a un determinato filtro per intent. Nota:per configurare un chiosco, utilizza InstallType per KIOSK anziché utilizzare le attività preferite permanenti.

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

string

L'attività che deve essere il gestore dell'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, che fa sì che Android Device Policy scelga un'attività appropriata dall'app per gestire l'intent.

actions[]

string

Le azioni intent da associare nel filtro. Se nel filtro sono incluse azioni, l'azione di un'intenzione deve essere uno di questi valori per la corrispondenza. Se non sono incluse azioni, l'azione dell'intent viene ignorata.

categories[]

string

Le categorie di intent da associare nel filtro. Un'intenzione include le categorie richieste, che devono essere incluse nel filtro per la corrispondenza. In altre parole, l'aggiunta di una categoria al filtro non influisce sulla corrispondenza, a meno che la 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 al canale principale 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 numero di minuti dopo 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 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 si estende a mezzanotte. Se il periodo di manutenzione specificato è inferiore a 30 minuti, il periodo effettivo viene esteso di 30 minuti oltre l'ora di inizio.

freezePeriods[]

object (FreezePeriod)

Un periodo di tempo che si ripete ogni 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 di bloccare il dispositivo 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 del dispositivo, che in genere richiede all'utente di accettare gli aggiornamenti di sistema.
AUTOMATIC Installa automaticamente non appena è disponibile un aggiornamento.
WINDOWED

Installazione automatica durante un periodo di manutenzione giornaliera. Vengono inoltre configurate 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 in modo permanente in primo piano possono essere aggiornate da Play.

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

POSTPONE Posticipa 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 si trova 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 eventuali periodi di blocco impostati, viene applicato il normale comportamento di criterio (automatico, con finestra o posticipato).

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

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

Nota: affinché i periodi di blocco vengano applicati, SystemUpdateType non può essere specificato come SYSTEM_UPDATE_TYPE_UNSPECIFIED, perché i periodi di blocco richiedono la definizione di un criterio.

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

object (Date)

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

endDate

object (Date)

La data di fine (inclusa) del periodo di blocco. Non deve essere successiva a 90 giorni dalla data di inizio. Se la data di fine è precedente alla data di inizio, il periodo di blocco viene considerato come chiusura dell'anno. Nota: year non deve essere impostato. Ad esempio, {"month": 1,"date": 30}.

Data

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

  • Una data completa, con valori di anno, mese e giorno diversi da zero.
  • Un mese e un giorno, con un anno pari a zero (ad esempio un anniversario).
  • Un anno da solo, con un mese e un giorno pari a zero.
  • Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

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

integer

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

month

integer

Mese di un anno. 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 valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

StatusReportingSettings

Impostazioni che controllano il comportamento dei report sullo 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

Indica se i report sulle app sono attivati.

deviceSettingsEnabled

boolean

Indica se i report sulle impostazioni del dispositivo sono attivati.

softwareInfoEnabled

boolean

Indica se i report sulle informazioni sul software sono attivati.

memoryInfoEnabled

boolean

Indica se i report sugli eventi relativi alla memoria sono attivati.

networkInfoEnabled

boolean

Indica se i report sulle informazioni sulla rete sono abilitati.

displayInfoEnabled

boolean

Indica se i report Display sono abilitati. I dati dei report non sono disponibili per i dispositivi di proprietà personale con profili di lavoro.

powerManagementEventsEnabled

boolean

Indica se il reporting sugli eventi di gestione dell'alimentazione è attivo. I dati dei report non sono disponibili per i dispositivi di proprietà personale 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 di proprietà personale con profili di lavoro.

systemPropertiesEnabled

boolean

Indica se i report sulle proprietà di sistema sono attivati.

applicationReportingSettings

object (ApplicationReportingSettings)

Impostazioni di generazione di report sulle applicazioni. Applicabile solo se applicationReportsEnabled è true.

commonCriteriaModeEnabled

boolean

Indica se i report Common Criteria Mode sono abilitati. Questa opzione è supportata solo sui dispositivi di proprietà dell'azienda.

ApplicationReportingSettings

Impostazioni che controllano il comportamento dei report sulle applicazioni.

Rappresentazione JSON
{
  "includeRemovedApps": boolean
}
Campi
includeRemovedApps

boolean

Indica 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 L'alimentazione è wireless.

ProxyInfo

Informazioni di 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, gli host per cui il proxy viene ignorato. I nomi host possono contenere caratteri jolly come *.example.com.

pacUri

string

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

ChoosePrivateKeyRule

Controlla l'accesso delle app alle chiavi private. La regola determina quale chiave privata, se presente, viene concessa da Android Device Policy all'app specificata. L'accesso viene concesso quando l'app chiama KeyChain.choosePrivateKeyAlias (o eventuali sovraccarichi) per richiedere un alias della chiave privata per un determinato URL o per regole non specifiche per URL (ovvero se urlPattern non è impostato o è impostato sulla stringa vuota o su .*) 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 e più di un choosePrivateKeyRules corrisponde, l'ultima regola di corrispondenza definisce quale alias chiave restituire.

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

string

Il pattern URL da confrontare con l'URL della richiesta. Se non è impostato o è vuoto, corrisponde a tutti gli URL. Viene utilizzata la sintassi dell'espressione regolare 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 Google Play. Se non vengono specificati nomi di pacchetti, l'alias viene fornito a tutte le app che chiamano KeyChain.choosePrivateKeyAlias o 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 chiama 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

Impedisce la connettività di rete quando la VPN non è connessa.

LocationMode

Il grado di rilevamento della posizione abilitato 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 abilitati tutti i metodi di rilevamento della posizione, inclusi GPS, reti e altri sensori. Su Android 9 e versioni successive, è equivalente 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, è equivalente a LOCATION_ENFORCED.

BATTERY_SAVING

Su Android 8 e versioni precedenti, è abilitato solo il provider di posizione di rete. Su Android 9 e versioni successive, è equivalente a LOCATION_ENFORCED.

OFF

Su Android 8 e versioni precedenti, l'impostazione e la precisione della posizione sono disattivate. Su Android 9 e versioni successive, è equivalente a LOCATION_DISABLED.

LOCATION_USER_CHOICE L'impostazione di geolocalizzazione non è limitata sul dispositivo. Non viene impostato o 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 di mitigazione intraprendere quando un dispositivo non è conforme ai suoi criteri. Per ogni regola è sempre presente un'azione di mitigazione implicita che imposta policyCompliant su false per la risorsa Device e mostra un messaggio sul dispositivo che indica che non è conforme ai relativi criteri. Se vuoi, puoi anche eseguire 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 impostata su true, la regola include un'azione di mitigazione per disattivare le app in modo che il dispositivo venga effettivamente disattivato, ma i dati delle app vengano conservati. Se sul dispositivo è in esecuzione un'app in modalità di attività bloccata, l'app verrà chiusa e verrà visualizzata un'interfaccia utente che mostra il motivo della mancata 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. Deve essere impostata esattamente una delle condizioni. condition può essere solo uno dei seguenti:
nonComplianceDetailCondition

object (NonComplianceDetailCondition)

Una condizione soddisfatta se esiste qualsiasi NonComplianceDetail corrispondente per il dispositivo.

apiLevelCondition

object (ApiLevelCondition)

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

NonComplianceDetailCondition

Una condizione della regola di conformità che viene soddisfatta se esiste qualsiasi NonComplianceDetail corrispondente per il dispositivo. Un NonComplianceDetail corrisponde a un NonComplianceDetailCondition se tutti i campi impostati all'interno del 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 del campo JSON di un campo Policy di primo livello. Se non è impostata, questa condizione corrisponde a qualsiasi nome di impostazione.

nonComplianceReason

enum (NonComplianceReason)

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

packageName

string

Il nome del pacchetto dell'app non conforme. Se non è impostato, questa condizione corrisponde a qualsiasi nome pacchetto.

ApiLevelCondition

Una condizione della regola di conformità che viene soddisfatta se il livello dell'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 il requisito minimo, questa condizione è soddisfatta. Deve essere maggiore di zero.

AppAutoUpdatePolicy

Alternativa consigliata: autoUpdateMode, impostato per app, offre una maggiore flessibilità in termini di frequenza di aggiornamento.

Quando autoUpdateMode è impostato su AUTO_UPDATE_POSTPONED o AUTO_UPDATE_HIGH_PRIORITY, questo campo non ha effetto.

Il criterio di aggiornamento automatico delle app, che controlla 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 la versione beta più recente.

EncryptionPolicy

Tipo di crittografia

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

PlayStoreMode

Possibili valori per il criterio della modalità Play Store.

Enum
PLAY_STORE_MODE_UNSPECIFIED Non specificato. Il valore predefinito è WHITELIST.
WHITELIST Sono disponibili solo le app incluse nei criteri e qualsiasi app non inclusa verrà disinstallata automaticamente dal dispositivo.
BLACKLIST Tutte le app sono disponibili e qualsiasi app che non deve essere sul dispositivo deve essere contrassegnata esplicitamente come "BLOCCATA" 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'intenzione 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 installType corrispondente nel criterio 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 una delle seguenti:
packageName

string

Nome del pacchetto dell'app da lanciare

PolicyEnforcementRule

Una regola che definisce le azioni da intraprendere se un dispositivo o un profilo di lavoro non è conforme al criterio specificato in settingName. In caso di più corrispondenze o più regole di applicazione attivate, verrà eseguita l'unione con l'azione più grave. Tuttavia, viene comunque monitorato il numero di regole attivate, inclusi l'ora di attivazione iniziale e tutti i dettagli di mancata conformità associati. Se viene soddisfatta la regola di applicazione più severa, viene 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 (se possibile) su come correggere 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 attiverà 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. Questa azione attiva anche un dispositivo o un profilo di lavoro per mostrare una notifica rivolta all'utente con informazioni (se possibile) su come correggere il problema di conformità. Nota: è necessario specificare anche wipeAction.

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

integer

Numero di giorni di mancata conformità alle norme prima del blocco del dispositivo o del profilo di lavoro. 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 di mancata conformità alle norme 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 controllano 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)

Imposta il comportamento di un dispositivo in modalità kiosk quando un utente preme e tiene premuto (pressione prolungata) il tasto di accensione.

systemErrorWarnings

enum (SystemErrorWarnings)

Specifica se le finestre di dialogo di errore di sistema per le app che hanno subito un arresto anomalo o non rispondono sono bloccate in modalità kiosk. Quando è bloccata, il sistema arresta forzatamente l'app come se l'utente scegliesse l'opzione "Chiudi app" nell'interfaccia utente.

systemNavigation

enum (SystemNavigation)

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

statusBar

enum (StatusBar)

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

deviceSettings

enum (DeviceSettings)

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

PowerButtonActions

Imposta il comportamento di un dispositivo in modalità kiosk quando un utente preme e tiene premuto (pressione prolungata) il tasto di accensione.

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

SystemErrorWarnings

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

Enum
SYSTEM_ERROR_WARNINGS_UNSPECIFIED Se non specificato, il valore predefinito è ERROR_AND_WARNINGS_MUTED.
ERROR_AND_WARNINGS_ENABLED Vengono visualizzate tutte le finestre di dialogo di errore di sistema, ad esempio arresti anomali e app che non risponde (ANR).
ERROR_AND_WARNINGS_MUTED Tutte le finestre di dialogo di errore di sistema, ad esempio arresti anomali e app che non risponde (ANR), sono bloccate. Quando è bloccata, il sistema forza l'interruzione dell'app come se l'utente la chiudesse dall'interfaccia utente.

SystemNavigation

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

Enum
SYSTEM_NAVIGATION_UNSPECIFIED Se 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 È attivo solo il pulsante Home.

StatusBar

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

Enum
STATUS_BAR_UNSPECIFIED Se non specificato, il valore predefinito è INFO_AND_NOTIFICATIONS_DISABLED.
NOTIFICATIONS_AND_SYSTEM_INFO_ENABLED

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

Nota: affinché questo criterio abbia effetto, il pulsante Home del dispositivo deve essere attivato utilizzando kioskCustomization.systemNavigation.

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

DeviceSettings

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

Enum
DEVICE_SETTINGS_UNSPECIFIED Se 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 impostarli.

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

enum (UntrustedAppsPolicy)

I criteri per le app non attendibili (app di origini sconosciute) applicati sul dispositivo. Sostituisce installUnknownSourcesAllowed (deprecated).

googlePlayProtectVerifyApps

enum (GooglePlayProtectVerifyApps)

Se è impostata l'applicazione della verifica di Google Play Protect. Sostituisce ensureVerifyAppsEnabled (ritirato).

developerSettings

enum (DeveloperSettings)

Controlla l'accesso alle impostazioni sviluppatore: opzioni sviluppatore e avvio sicuro. Sostituisce safeBootDisabled (ritirato) e debuggingFeaturesAllowed (ritirato).

commonCriteriaMode

enum (CommonCriteriaMode)

Controlla la modalità Common Criteria: standard di sicurezza definiti nei Common Criteria for Information Technology Security Evaluation (CC). L'attivazione della modalità Common Criteria aumenta alcuni componenti di sicurezza su un dispositivo. Per maggiori dettagli, vedi CommonCriteriaMode.

Avviso: la modalità Common Criteria applica un modello di sicurezza rigoroso, in genere richiesto solo per i prodotti IT utilizzati nei sistemi di sicurezza nazionale e in altre organizzazioni altamente sensibili. L'utilizzo standard del dispositivo potrebbe essere interessato. Viene attivata solo se necessario. Se la modalità Common Criteria viene disattivata dopo essere stata attivata in precedenza, tutte le reti Wi-Fi configurate dall'utente potrebbero andare perse e potrebbe essere necessario riconfigurare le reti Wi-Fi configurate dall'azienda che richiedono l'input dell'utente.

personalAppsThatCanReadWorkNotifications[]

string

App personali che possono leggere le notifiche del profilo di lavoro utilizzando un NotificationListenerService. Per impostazione predefinita, nessuna app personale (ad eccezione delle app di sistema) può leggere le notifiche di lavoro. Ogni valore nell'elenco deve essere un nome di pacchetto.

mtePolicy

enum (MtePolicy)

Facoltativo. Controlla l'estensione MTE (Memory Tagging Extension) sul dispositivo. Per applicare le modifiche al criterio MTE, è necessario riavviare il dispositivo.

contentProtectionPolicy

enum (ContentProtectionPolicy)

Facoltativo. Controlla se la protezione dei contenuti, che esegue la scansione per rilevare app ingannevoli, è attivata. Questa funzionalità è supportata su Android 15 e versioni successive.

UntrustedAppsPolicy

I criteri per le app non attendibili (app di origini sconosciute) applicati sul dispositivo. Sostituisce installUnknownSourcesAllowed (deprecated).

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

GooglePlayProtectVerifyApps

Se è impostata l'applicazione della verifica di Google Play Protect. Sostituisce ensureVerifyAppsEnabled (ritirato).

Enum
GOOGLE_PLAY_PROTECT_VERIFY_APPS_UNSPECIFIED Non specificato. Il valore predefinito è VERIFY_APPS_ENFORCED.
VERIFY_APPS_ENFORCED Predefinita. Attiva forzatamente la verifica dell'app.
VERIFY_APPS_USER_CHOICE Consente all'utente di scegliere se attivare la verifica delle app.

DeveloperSettings

Controlla l'accesso alle impostazioni sviluppatore: opzioni sviluppatore e avvio sicuro. Sostituisce safeBootDisabled (ritirato) e debuggingFeaturesAllowed (ritirato).

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

CommonCriteriaMode

Controlla la modalità Common Criteria: standard di sicurezza definiti nei Common Criteria for Information Technology Security Evaluation (CC). L'attivazione della modalità Common Criteria aumenta alcuni componenti di sicurezza su un dispositivo, tra cui:

  1. Crittografia AES-GCM delle chiavi a lungo termine Bluetooth
  2. Memorizze le configurazioni Wi-Fi
  3. Verifica aggiuntiva dei certificati di rete che richiede l'utilizzo di TLSv1.2 per la connessione agli host di destinazione dell'API AM
  4. Controllo dell'integrità dei criteri crittografici. Ti consigliamo di impostare statusReportingSettings.commonCriteriaModeEnabled su true per ottenere lo stato del controllo dell'integrità dei criteri. Se la verifica della firma del criterio non va a buon fine, il criterio non viene applicato sul dispositivo e commonCriteriaModeInfo.policy_signature_verification_status viene impostato su POLICY_SIGNATURE_VERIFICATION_FAILED.

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, in genere richiesto solo per i prodotti IT utilizzati nei sistemi di sicurezza nazionale e in altre organizzazioni altamente sensibili. L'utilizzo standard del dispositivo potrebbe essere interessato. Viene attivata solo se necessario. Se la modalità Common Criteria viene disattivata dopo essere stata attivata in precedenza, tutte le reti Wi-Fi configurate dall'utente potrebbero andare perse e potrebbe essere necessario riconfigurare le reti Wi-Fi configurate dall'azienda che richiedono l'input dell'utente.

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 Attiva la modalità Common Criteria.

MtePolicy

Controlla l'estensione MTE (Memory Tagging Extension) 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 l'MTE sul dispositivo, se supportato.
MTE_ENFORCED

La funzionalità MTE è attivata sul dispositivo e l'utente non è autorizzato a modificarla. Questa impostazione può essere impostata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda. Un nonComplianceDetail con MANAGEMENT_MODE viene segnalato per altre modalità di gestione. Viene segnalato un nonComplianceDetail con DEVICE_INCOMPATIBLE se il dispositivo non supporta MTE.

Supportato su Android 14 e versioni successive. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 14.

MTE_DISABLED

L'MTE è disattivato sul dispositivo e l'utente non è autorizzato a modificare questa impostazione. Questo vale solo per i dispositivi completamente gestiti. In altri casi, viene segnalato un nonComplianceDetail con MANAGEMENT_MODE. Viene segnalato un nonComplianceDetail con DEVICE_INCOMPATIBLE se il dispositivo non supporta MTE.

Supportato su Android 14 e versioni successive. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 14.

ContentProtectionPolicy

Controlla se la protezione dei contenuti, che esegue la scansione per rilevare app ingannevoli, è attivata. Questa funzionalità è supportata su Android 15 e versioni successive.

Enum
CONTENT_PROTECTION_POLICY_UNSPECIFIED Non specificato. Il valore predefinito è CONTENT_PROTECTION_DISABLED.
CONTENT_PROTECTION_DISABLED La protezione dei contenuti è disattivata e l'utente non può modificarla.
CONTENT_PROTECTION_ENFORCED

La protezione dei contenuti è attivata e l'utente non può modificarla.

Supportato su Android 15 e versioni successive. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 15.

CONTENT_PROTECTION_USER_CHOICE

La protezione dei contenuti non è controllata dalle norme. L'utente può scegliere il comportamento della protezione dei contenuti.

Supportato su Android 15 e versioni successive. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 15.

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 il valore è true, la fotocamera è disattivata nel profilo personale.

screenCaptureDisabled

boolean

Se true, la cattura dello 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 i seguenti:

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

personalPlayStoreMode

enum (PlayStoreMode)

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

personalApplications[]

object (PersonalApplicationPolicy)

Norme applicate alle applicazioni nel profilo personale.

PlayStoreMode

Da utilizzare 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 sono disponibili per l'installazione nel profilo personale, tranne quelle il cui installType è BLOCKED in personalApplications.

BLOCKLIST Tutte le app del Play Store sono disponibili per l'installazione nel profilo personale, tranne quelle il cui installType è BLOCKED in personalApplications.
ALLOWLIST Nel profilo personale è consentito installare solo le app specificate esplicitamente in personalApplications con installType impostato su AVAILABLE.

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 un'applicazione con profilo personale può avere.

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à installata sul dispositivo, verrà disinstallata.
AVAILABLE L'app è disponibile per l'installazione nel profilo personale.

AutoDateAndTimeZone

Indica se la data, l'ora e il fuso orario automatici sono attivati 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 La data, l'ora e il fuso orario automatici sono a scelta dell'utente.
AUTO_DATE_AND_TIME_ZONE_ENFORCED Applica 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. Viene segnalato un nonComplianceDetail con MANAGEMENT_MODE se il dispositivo non ha un profilo di lavoro.

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

enum (ShowWorkContactsInPersonalProfile)

Indica 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 le app dell'altro profilo. Controlla in modo specifico la semplice condivisione dei dati tramite intent. La gestione di altri canali di comunicazione tra profili, come la ricerca dei contatti, la copia/incolla o le app personali e di lavoro collegate, viene configurata 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 delle app escluse dall'impostazione ShowWorkContactsInPersonalProfile. Affinché questo valore venga impostato, ShowWorkContactsInPersonalProfile deve essere impostato su uno dei seguenti valori:

Supportato su Android 14 e versioni successive. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 14.

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 contatto di lavoro viene visualizzato da un'app personale, non è possibile garantire che rimanga nella stessa app, in quanto il contatto potrebbe essere condiviso o trasferito a qualsiasi altra app, a seconda del comportamento dell'app consentita.

Enum
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_UNSPECIFIED

Non specificato. Il valore predefinito è SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED.

Se questo valore è 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 cercarli.

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

Supportato su Android 7.0 e versioni successive. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 7.0.

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 opzione è impostata, le app personali specificate in exemptionsToShowWorkContactsInPersonalProfile vengono inserite nella lista bloccata e non possono accedere direttamente ai contatti del profilo di lavoro.

Supportato su Android 7.0 e versioni successive. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 7.0.

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 predefinite dell'OEM. Né le app Telefono, Messaggi e Contatti configurate dall'utente né qualsiasi altro sistema o app installate su Google Play potranno eseguire query direttamente sui 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.

Supportato su Android 14 e versioni successive. Se questo valore è impostato su un dispositivo con una 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 profilo personale il testo copiato dal profilo di lavoro. Il testo copiato dal profilo personale può essere incollato nel profilo di lavoro e viceversa.
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 le app dell'altro profilo. Controlla in modo specifico la semplice condivisione dei dati tramite intent. Sono incluse azioni come l'apertura di un browser web, di una mappa, la condivisione di contenuti, l'apertura di un documento e così via. La gestione di altri canali di comunicazione tra profili, come la ricerca di contatti, la copia/incolla o le app personali e di lavoro collegate, viene configurata 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 dal profilo personale al profilo di lavoro e dal profilo di lavoro al profilo personale.
DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED Predefinita. Impedisce agli utenti di condividere dati dal profilo di lavoro con le app nel profilo personale. I dati personali possono essere condivisi con le app di lavoro.
CROSS_PROFILE_DATA_SHARING_ALLOWED I dati di entrambi i profili possono essere condivisi con l'altro profilo.

WorkProfileWidgetsDefault

Controlla se le applicazioni del profilo di lavoro sono autorizzate ad aggiungere widget alla schermata Home, se non sono definiti criteri specifici per le app. In caso contrario, il criterio specifico dell'app avrà la precedenza.

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, 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, non potrà aggiungere widget alla schermata Home.

PreferentialNetworkService

Controlla se il servizio di rete preferenziale è attivo nel 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 nel profilo di lavoro.
PREFERENTIAL_NETWORK_SERVICE_ENABLED Il servizio di rete preferito è attivo nel profilo di lavoro.

UsageLog

Controlla 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 abilitati. Tieni presente che gli utenti riceveranno messaggi sul dispositivo quando la registrazione dell'utilizzo è attivata.

uploadOnCellularAllowed[]

enum (LogType)

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

LogType

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

Enum
LOG_TYPE_UNSPECIFIED Questo valore non viene utilizzato.
SECURITY_LOGS Attiva la registrazione degli eventi di sicurezza sul dispositivo, ad esempio quando la password del dispositivo viene inserita in modo errato o viene montato lo spazio di archiviazione rimovibile. Consulta UsageLogEvent per una descrizione completa degli eventi di sicurezza registrati. Supportato per i dispositivi completamente gestiti su Android 7 e versioni successive. Supportato 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 ignorato dall'ambito delegato dell'applicazione SECURITY_LOGS
NETWORK_ACTIVITY_LOGS Attiva il logging degli eventi di rete sul dispositivo, come le ricerche DNS e le connessioni TCP. Consulta UsageLogEvent per una descrizione completa degli eventi di rete registrati. Supportato per i dispositivi completamente gestiti su Android 8 e versioni successive. Supportato 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 ignorato dall'ambito delegato dell'applicazione NETWORK_ACTIVITY_LOGS

CameraAccess

Controlla l'uso della fotocamera e se l'utente ha accesso al pulsante di attivazione/disattivazione dell'accesso alla fotocamera. L'opzione di attivazione/disattivazione dell'accesso alla fotocamera è disponibile su Android 12 e versioni successive. Come principio generale, la possibilità di disattivare la fotocamera 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 si applica a livello di dispositivo. Per informazioni specifiche, consulta i valori dell'enum.

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

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

Non sono presenti limitazioni esplicite per l'opzione di 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 perché tutte le fotocamere sono disattivate. Sui dispositivi con un profilo di lavoro, questo pulsante di attivazione/disattivazione non influisce sulle app nel profilo di lavoro, ma sulle app esterne al profilo di lavoro.

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 è in grado di utilizzare l'opzione di attivazione/disattivazione dell'accesso alla fotocamera. Sui dispositivi non completamente gestiti o con Android 11 o versioni precedenti, questo valore è equivalente a CAMERA_ACCESS_USER_CHOICE.

MicrophoneAccess

Sui dispositivi completamente gestiti, controlla l'utilizzo del microfono e se l'utente ha accesso al pulsante di attivazione/disattivazione dell'accesso al 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 è true, è equivalente a MICROPHONE_ACCESS_DISABLED. In caso contrario, è equivalente a MICROPHONE_ACCESS_USER_CHOICE.
MICROPHONE_ACCESS_USER_CHOICE Il campo unmuteMicrophoneDisabled viene ignorato. Questo è il comportamento predefinito del dispositivo: il microfono del 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, si applica a livello di dispositivo).

Il pulsante di attivazione/disattivazione dell'accesso al microfono non ha alcun effetto perché il microfono è disattivato.

MICROPHONE_ACCESS_ENFORCED Il campo unmuteMicrophoneDisabled viene ignorato. Il microfono sul dispositivo è disponibile. Sui dispositivi con Android 12 e versioni successive, l'utente non è in grado di utilizzare l'opzione di attivazione/disattivazione dell'accesso al microfono. Sui dispositivi con Android 11 o versioni precedenti, questo valore è equivalente a MICROPHONE_ACCESS_USER_CHOICE.

DeviceConnectivityManagement

Riguarda 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)
  },
  "wifiRoamingPolicy": {
    object (WifiRoamingPolicy)
  }
}
Campi
usbDataAccess

enum (UsbDataAccess)

Controlla quali file e/o dati possono essere trasferiti tramite USB. Supportato solo sui dispositivi di proprietà dell'azienda.

configureWifi

enum (ConfigureWifi)

Controlla i privilegi di configurazione del Wi-Fi. In base all'opzione impostata, l'utente avrà un controllo completo, limitato o nullo sulla configurazione delle reti Wi-Fi.

wifiDirectSettings

enum (WifiDirectSettings)

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

tetheringSettings

enum (TetheringSettings)

Controlla le impostazioni del tethering. In base al valore impostato, all'utente non è consentito utilizzare parzialmente o completamente diverse forme di tethering.

wifiSsidPolicy

object (WifiSsidPolicy)

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

wifiRoamingPolicy

object (WifiRoamingPolicy)

Facoltativo. Norme sul roaming Wi-Fi.

UsbDataAccess

Controlla quali file e/o dati possono essere trasferiti tramite USB. Non influisce sulle funzioni di ricarica. Supportato 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 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 la connessione di mouse e tastiera. usbFileTransferDisabled viene ignorato.
DISALLOW_USB_DATA_TRANSFER Se impostato, tutti i tipi di trasferimenti di dati USB sono vietati. Supportato per i dispositivi con Android 12 o versioni successive con HAL USB 1.3 o versioni successive. Se l'impostazione non è supportata, verrà impostato DISALLOW_USB_FILE_TRANSFER. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 12. Viene segnalato un nonComplianceDetail con DEVICE_INCOMPATIBLE se il dispositivo non dispone di HAL USB 1.3 o versioni successive. usbFileTransferDisabled viene ignorato.

ConfigureWifi

Controlla i privilegi di configurazione del Wi-Fi. In base all'opzione impostata, l'utente avrà un controllo completo, limitato o nullo sulla 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, è equivalente a DISALLOW_CONFIGURING_WIFI.
ALLOW_CONFIGURING_WIFI L'utente è autorizzato a 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. Supportato su Android 13 e versioni successive, su dispositivi completamente gestiti e profili di lavoro su dispositivi di proprietà dell'azienda. Se l'impostazione non è supportata, viene impostato ALLOW_CONFIGURING_WIFI. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13. wifiConfigDisabled viene ignorato.
DISALLOW_CONFIGURING_WIFI Non consente la configurazione delle reti Wi-Fi. L'impostazione wifiConfigDisabled viene ignorata quando viene impostato questo valore. Supportato sui dispositivi completamente gestiti e sul profilo di lavoro sui dispositivi di proprietà dell'azienda, su tutti i livelli API supportati. Per i dispositivi completamente gestiti, questa 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 l'utente non è autorizzato ad aggiungere, rimuovere o modificare le reti Wi-Fi. Nota: se non è possibile stabilire una connessione di rete all'avvio e la configurazione del Wi-Fi è disattivata, viene visualizzata la finestra di fuga di rete per aggiornare i criteri del dispositivo (vedi networkEscapeHatchEnabled).

WifiDirectSettings

Controlla le impostazioni Wi-Fi Direct. Supportato 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 è autorizzato a utilizzare il Wi-Fi Direct.
DISALLOW_WIFI_DIRECT L'utente non è autorizzato a utilizzare il Wi-Fi Direct. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.

TetheringSettings

Controlla la misura in cui l'utente è autorizzato a utilizzare diverse forme di tethering, come il tethering Wi-Fi, il tethering 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, è equivalente 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. Supportato sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive. Se l'impostazione non è supportata, verrà impostato ALLOW_ALL_TETHERING. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13. tetheringConfigDisabled viene ignorato.
DISALLOW_ALL_TETHERING Non sono consentite tutte le forme di tethering. Supportato sui dispositivi completamente gestiti e sul profilo 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 questo non influisce sulle reti che possono essere configurate sul dispositivo. Supportato 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 da applicare nel criterio. Questo campo deve essere compilato quando WifiSsidPolicyType è impostato su WIFI_SSID_ALLOWLIST. Se questo valore è impostato su un elenco non vuoto, viene riportato un dettaglio nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13 e un nonComplianceDetail con MANAGEMENT_MODE per i dispositivi non di proprietà dell'azienda.

WifiSsidPolicyType

I tipi di criteri SSID 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 all'SSID a cui può connettersi il dispositivo.
WIFI_SSID_DENYLIST Il dispositivo non riesce a connettersi a nessuna rete Wi-Fi il cui SSID è in wifiSsids, ma può connettersi ad altre reti.
WIFI_SSID_ALLOWLIST Il dispositivo può effettuare connessioni Wi-Fi solo agli SSID in wifiSsids. wifiSsids non deve essere vuoto. Il dispositivo non potrà connettersi ad altre reti Wi-Fi.

WifiSsid

Rappresenta un SSID Wi-Fi.

Rappresentazione JSON
{
  "wifiSsid": string
}
Campi
wifiSsid

string

Obbligatorio. SSID del Wi-Fi rappresentato come stringa.

WifiRoamingPolicy

Norme sul roaming Wi-Fi.

Rappresentazione JSON
{
  "wifiRoamingSettings": [
    {
      object (WifiRoamingSetting)
    }
  ]
}
Campi
wifiRoamingSettings[]

object (WifiRoamingSetting)

Facoltativo. Impostazioni del roaming Wi-Fi. Gli SSID forniti in questo elenco devono essere univoci, altrimenti il criterio verrà rifiutato.

WifiRoamingSetting

Impostazione del roaming Wi-Fi.

Rappresentazione JSON
{
  "wifiSsid": string,
  "wifiRoamingMode": enum (WifiRoamingMode)
}
Campi
wifiSsid

string

Obbligatorio. SSID della rete Wi-Fi.

wifiRoamingMode

enum (WifiRoamingMode)

Obbligatorio. Modalità di roaming Wi-Fi per l'SSID specificato.

WifiRoamingMode

Modalità roaming Wi-Fi.

Enum
WIFI_ROAMING_MODE_UNSPECIFIED Non specificato. Il valore predefinito è WIFI_ROAMING_DEFAULT.
WIFI_ROAMING_DEFAULT Modalità di roaming Wi-Fi predefinita del dispositivo.
WIFI_ROAMING_AGGRESSIVE Modalità di roaming aggressiva che consente un roaming Wi-Fi più rapido. Supportato su Android 15 e versioni successive sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà dell'azienda. Un nonComplianceDetail con MANAGEMENT_MODE viene segnalato per altre modalità di gestione. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 15. Viene segnalato un nonComplianceDetail con DEVICE_INCOMPATIBLE se il dispositivo non supporta la modalità di roaming aggressivo.

DeviceRadioState

Controlli per le impostazioni radio del dispositivo.

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

enum (WifiState)

Controlla lo stato attuale del Wi-Fi e se l'utente può modificarlo.

airplaneModeState

enum (AirplaneModeState)

Controlla se la modalità aereo può essere attivata o disattivata dall'utente.

ultraWidebandState

enum (UltraWidebandState)

Controlla 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 2G della rete mobile.

minimumWifiSecurityLevel

enum (MinimumWifiSecurityLevel)

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

WifiState

Controlla se il Wi-Fi è attivo o meno e se l'utente può modificare questo stato. Supportato 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 è autorizzato ad attivare/disattivare il Wi-Fi.
WIFI_ENABLED Il Wi-Fi è attivo e l'utente non è autorizzato a disattivarlo. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.
WIFI_DISABLED Il Wi-Fi è disattivato e l'utente non è autorizzato ad attivarlo. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.

AirplaneModeState

Controlla lo stato della modalità aereo e se l'utente può attivarla o disattivarla. Supportato su Android 9 e versioni successive. Supportato 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. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 9.

UltraWidebandState

Controlla lo stato dell'impostazione della banda ultralarga e se l'utente può attivarla o disattivarla. Supportato su Android 14 e versioni successive. Supportato 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 tecnologia ultra wideband.
ULTRA_WIDEBAND_DISABLED La banda ultralarga è disattivata. L'utente non è autorizzato ad attivare la tecnologia ultra wideband tramite le impostazioni. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 14.

CellularTwoGState

Controlla lo stato dell'impostazione 2G cellulare e se l'utente può attivarla o disattivarla. Supportato su Android 14 e versioni successive. Supportato 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 è autorizzato ad attivare o disattivare la rete mobile 2G.
CELLULAR_TWO_G_DISABLED La rete mobile 2G è disattivata. L'utente non è autorizzato ad attivare la rete 2G tramite le impostazioni. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 14.

MinimumWifiSecurityLevel

Definisce i diversi livelli di sicurezza Wi-Fi minimi richiesti per connettersi alle reti Wi-Fi. Supportato su Android 13 e versioni successive. Supportato 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, il che significa che 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, WPA2-PSK è la sicurezza minima richiesta. Il dispositivo non potrà connettersi alle reti Wi-Fi aperte. Questo criterio è più restrittivo di OPEN_NETWORK_SECURITY. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.
ENTERPRISE_NETWORK_SECURITY Una rete EAP aziendale è il livello di sicurezza minimo richiesto. Il dispositivo non potrà connettersi alla rete Wi-Fi al di sotto di questo livello di sicurezza. Questo criterio è più restrittivo di PERSONAL_NETWORK_SECURITY. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.
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 criterio è più restrittivo di ENTERPRISE_NETWORK_SECURITY. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.

CredentialProviderPolicyDefault

Controlla quali app sono autorizzate ad agire come fornitori di credenziali su Android 14 e versioni successive. Queste app memorizzano le credenziali. Per maggiori dettagli, consulta questa e questa pagina. 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 specificato non sono autorizzate a fungere da provider di credenziali.
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED_EXCEPT_SYSTEM Le app con credentialProviderPolicy non specificato non sono autorizzate ad agire come fornitori di credenziali, ad eccezione dei fornitori di credenziali predefiniti dell'OEM. I fornitori di credenziali predefiniti dell'OEM sono sempre autorizzati ad agire come fornitori di credenziali.

PrintingPolicy

Controlla se la stampa è consentita. Questa funzionalità è 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. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 9.
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. Controlla le impostazioni di luminosità dello schermo.

screenTimeoutSettings

object (ScreenTimeoutSettings)

Facoltativo. Controlla 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. Controlla la modalità di luminosità dello schermo.

screenBrightness

integer

Facoltativo. La luminosità dello schermo compresa tra 1 e 255, dove 1 è la luminosità più bassa e 255 la più alta. Un valore pari a 0 (predefinito) indica che la luminosità dello schermo non è impostata. Qualsiasi altro valore viene rifiutato. Per impostare questo valore, screenBrightnessMode deve essere BRIGHTNESS_AUTOMATIC o BRIGHTNESS_FIXED. Supportato su Android 9 e versioni successive sui dispositivi completamente gestiti. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 9. Supportato nei profili di lavoro sui dispositivi di proprietà dell'azienda su Android 15 e versioni successive.

ScreenBrightnessMode

Controlla la modalità di luminosità dello schermo.

Enum
SCREEN_BRIGHTNESS_MODE_UNSPECIFIED Non specificato. Il valore predefinito è BRIGHTNESS_USER_CHOICE.
BRIGHTNESS_USER_CHOICE L'utente è autorizzato a configurare la luminosità dello schermo. screenBrightness non deve essere impostato.
BRIGHTNESS_AUTOMATIC La modalità di luminosità dello schermo è automatica, in quanto la luminosità viene regolata automaticamente e l'utente non è autorizzato a configurarla. screenBrightness può comunque essere impostato e viene preso in considerazione durante la regolazione automatica della luminosità. Supportato su Android 9 e versioni successive sui dispositivi completamente gestiti. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 9. Supportato nei profili di lavoro sui dispositivi di proprietà dell'azienda su Android 15 e versioni successive.
BRIGHTNESS_FIXED La modalità di luminosità dello schermo è fissa, la luminosità è impostata su screenBrightness e l'utente non è autorizzato a configurarla. È necessario impostare screenBrightness. Supportato su Android 9 e versioni successive sui dispositivi completamente gestiti. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 9. Supportato nei profili di lavoro sui dispositivi di proprietà dell'azienda su Android 15 e versioni successive.

ScreenTimeoutSettings

Controlla le impostazioni di spegnimento dello schermo.

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

enum (ScreenTimeoutMode)

Facoltativo. Controlla se l'utente è autorizzato a configurare il timeout dello schermo.

screenTimeout

string (Duration format)

Facoltativo. Controlla la durata dello spegnimento dello schermo. La durata del timeout dello schermo deve essere maggiore di 0, altrimenti viene rifiutata. Inoltre, non deve essere superiore a maximumTimeToLock, altrimenti il timeout dello schermo viene impostato su maximumTimeToLock e viene segnalato un NonComplianceDetail con il motivo INVALID_VALUE e il motivo specifico SCREEN_TIMEOUT_GREATER_THAN_MAXIMUM_TIME_TO_LOCK. Se il timeout dello schermo è inferiore a un determinato limite inferiore, viene impostato su questo valore. Il limite inferiore può variare in base al dispositivo. Se questo valore è impostato, screenTimeoutMode deve essere SCREEN_TIMEOUT_ENFORCED. Supportato su Android 9 e versioni successive sui dispositivi completamente gestiti. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 9. Supportato nei profili di lavoro sui dispositivi di proprietà dell'azienda su Android 15 e versioni successive.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

ScreenTimeoutMode

Controlla se l'utente è autorizzato a configurare il timeout 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 il timeout dello schermo. screenTimeout non deve essere impostato.
SCREEN_TIMEOUT_ENFORCED Il timeout dello schermo è impostato su screenTimeout e l'utente non è autorizzato a configurarlo. È necessario impostare screenTimeout. Supportato su Android 9 e versioni successive sui dispositivi completamente gestiti. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 9. Supportato nei profili di lavoro sui dispositivi di proprietà dell'azienda su Android 15 e versioni successive.

AssistContentPolicy

Controlla se è consentito inviare AssistContent a un'app privilegiata, ad esempio un'app di assistenza. AssistContent include screenshot e informazioni su un'app, ad esempio il nome del pacchetto. Questa funzionalità è supportata su Android 15 e versioni successive.

Enum
ASSIST_CONTENT_POLICY_UNSPECIFIED Non specificato. Il valore predefinito è ASSIST_CONTENT_ALLOWED.
ASSIST_CONTENT_DISALLOWED

L'invio dei contenuti di assistenza a un'app privilegiata è bloccato.

Supportato su Android 15 e versioni successive. Viene segnalato un nonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 15.

ASSIST_CONTENT_ALLOWED

È consentito inviare i contenuti di assistenza a un'app con privilegi.

Supportato su Android 15 e versioni successive.

Metodi

delete

Consente di eliminare un criterio.

get

Recupera un criterio.

list

Elenca i criteri per una determinata azienda.

patch

Aggiorna o crea un criterio.