REST Resource: enterprises.policies

Risorsa: Policy

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

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),
  "workAccountSetupConfig": {
    object (WorkAccountSetupConfig)
  },
  "wipeDataFlags": [
    enum (WipeDataFlag)
  ],
  "enterpriseDisplayNameVisibility": enum (EnterpriseDisplayNameVisibility),
  "appFunctions": enum (AppFunctions)
}
Campi
name

string

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

string (int64 format)

La versione delle norme. Questo è un campo di sola lettura. La versione viene incrementata ogni volta che le norme vengono aggiornate.
applications[]

object (ApplicationPolicy)

Norma applicata alle app. Può contenere al massimo 3000 elementi.
maximumTimeToLock

string (int64 format)

Tempo massimo in millisecondi per l'attività utente prima che il dispositivo si blocchi. Un valore pari a 0 indica che non esistono limitazioni.
screenCaptureDisabled

boolean

Indica se l'acquisizione schermo è disattivata.
cameraDisabled
(deprecated)

boolean

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

enum (KeyguardDisabledFeature)

Disattivare personalizzazioni del blocco tastiera, come i widget.
defaultPermissionPolicy

enum (PermissionPolicy)

I criteri di autorizzazione predefiniti per le richieste di autorizzazione di runtime.
persistentPreferredActivities[]

object (PersistentPreferredActivity)

Attività del gestore di intent predefinito.
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 la modalità di applicazione degli aggiornamenti del sistema operativo. Se il tipo di aggiornamento è WINDOWED, la finestra di aggiornamento verrà applicata automaticamente anche agli aggiornamenti delle app Google Play.

Nota:gli aggiornamenti di sistema Google Play (chiamati anche aggiornamenti Mainline) vengono scaricati automaticamente e l'installazione richiede il riavvio del dispositivo. Per ulteriori dettagli, consulta la sezione Mainline 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 all'utente non è mai consentito aggiungere o rimuovere utenti.
adjustVolumeDisabled

boolean

Indica se la regolazione del volume principale è disattivata. Disattiva anche l'audio del dispositivo. L'impostazione ha effetto solo sui dispositivi completamente gestiti.
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 il montaggio di supporti esterni fisici da parte dell'utente è disattivato.
modifyAccountsDisabled

boolean

Se l'aggiunta o la rimozione di account è disattivata.
safeBootDisabled
(deprecated)

boolean

Indica se il riavvio del dispositivo in modalità provvisoria è disattivato.
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 disabilitate le notifiche, le impostazioni rapide e altre sovrapposizioni dello 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 è true, questa opzione disattiva la schermata di blocco per i display primari e/o secondari. Questo criterio è supportato solo nella modalità di gestione dei dispositivi dedicati.
minimumApiLevel

integer

Il livello API Android minimo consentito.
statusReportingSettings

object (StatusReportingSettings)

Impostazioni di generazione dei report sullo stato
bluetoothContactSharingDisabled

boolean

Indica se la condivisione dei contatti tramite Bluetooth è disattivata.
shortSupportMessage

object (UserFacingMessage)

Un messaggio visualizzato dall'utente nella schermata delle impostazioni in cui la funzionalità è stata disattivata dall'amministratore. Se il messaggio supera i 200 caratteri, potrebbe essere troncato.
longSupportMessage

object (UserFacingMessage)

Un messaggio visualizzato dall'utente nella schermata delle impostazioni degli amministratori del dispositivo.
passwordRequirements
(deprecated)

object (PasswordRequirements)

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

Nota:

Qui non è possibile utilizzare i valori basati sulla complessità di PasswordQuality, ovvero COMPLEXITY_LOW, COMPLEXITY_MEDIUM e COMPLEXITY_HIGH. unifiedLockSettings non può essere utilizzato qui.
wifiConfigsLockdownEnabled
(deprecated)

boolean

Questo è deprecato.
bluetoothConfigDisabled

boolean

Indica se la configurazione del Bluetooth è disattivata.
cellBroadcastsConfigDisabled

boolean

Indica se la configurazione di cell broadcast è disabilitata.
credentialsConfigDisabled

boolean

Indica se la configurazione delle credenziali utente è disattivata.
mobileNetworksConfigDisabled

boolean

Se la configurazione delle reti mobili è disattivata.
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 è disattivata.
wifiConfigDisabled
(deprecated)

boolean

Se la configurazione delle reti Wi-Fi è disattivata. Supportato su dispositivi completamente gestiti e profili di lavoro su dispositivi di proprietà dell'azienda. Per i dispositivi completamente gestiti, se questo valore viene impostato su true, vengono rimosse tutte le reti configurate e vengono mantenute 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 visualizzato il meccanismo di escape della rete per aggiornare i criteri del dispositivo (vedi networkEscapeHatchEnabled).
createWindowsDisabled

boolean

Indica se la creazione di finestre diverse da quelle delle app è disattivata.
networkResetDisabled

boolean

Indica se il ripristino delle impostazioni di rete è disattivato.
outgoingBeamDisabled

boolean

Se l'utilizzo di NFC per trasferire dati dalle app è disabilitato.
outgoingCallsDisabled

boolean

Se le chiamate in uscita sono disattivate.
removeUserDisabled

boolean

Se la rimozione di altri utenti è disattivata.
shareLocationDisabled

boolean

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

Se l'invio e la ricezione di SMS sono disabilitati.
unmuteMicrophoneDisabled
(deprecated)

boolean

Se microphoneAccess è impostato su un valore diverso da MICROPHONE_ACCESS_UNSPECIFIED, questa impostazione non ha effetto. Altrimenti, questo campo controlla se i microfoni sono disattivati: se è 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 funzionalità è 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à di alimentazione a batteria per cui il dispositivo rimane acceso. Quando utilizzi questa impostazione, ti consigliamo di disattivare 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, un proxy HTTP globale può essere utile. Se il proxy non è accessibile, l'accesso alla rete potrebbe interrompersi. Il proxy globale è solo un consiglio e alcune app potrebbero ignorarlo.
setUserIconDisabled

boolean

Indica se la modifica dell'icona utente è disattivata. L'impostazione ha effetto solo sui dispositivi completamente gestiti.
setWallpaperDisabled

boolean

Indica se la modifica dello sfondo è disattivata.
choosePrivateKeyRules[]

object (ChoosePrivateKeyRule)

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

object (AlwaysOnVpnPackage)

Configurazione per una connessione VPN sempre attiva. Utilizza vpnConfigDisabled per impedire la modifica di questa impostazione.
frpAdminEmails[]

string

Indirizzi email degli amministratori del dispositivo per la protezione ripristino dati di fabbrica. Quando il dispositivo viene ripristinato ai dati di fabbrica, uno di questi amministratori dovrà accedere con l'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 dati in roaming sono disattivati.
locationMode

enum (LocationMode)

Il grado di rilevamento della posizione attivato.
networkEscapeHatchEnabled

boolean

Indica se il meccanismo di emergenza di rete è attivato. Se non è possibile stabilire una connessione di rete all'avvio, l'escape hatch chiede all'utente di connettersi temporaneamente a una rete per aggiornare il criterio del dispositivo. Dopo l'applicazione del criterio, la rete temporanea verrà dimenticata e il dispositivo continuerà l'avvio. In questo modo, non si verifica l'impossibilità di connettersi a una rete se non è presente una rete adatta nell'ultima policy e il dispositivo si avvia in un'app in modalità di blocco attività oppure l'utente non riesce ad accedere alle impostazioni del dispositivo.

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

boolean

Indica se il Bluetooth è disattivato. Preferisci questa impostazione a bluetoothConfigDisabled perché bluetoothConfigDisabled può essere ignorata 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. Il limite massimo è di 100 regole. Utilizza invece le regole di applicazione delle norme.
blockApplicationsEnabled
(deprecated)

boolean

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 sono più presenti nel criterio, vengono disinstallate automaticamente.
installUnknownSourcesAllowed
(deprecated)

boolean

Questo campo non ha effetto.
debuggingFeaturesAllowed
(deprecated)

boolean

Indica se all'utente è consentito attivare le funzionalità di debug.
funDisabled

boolean

Indica se l'utente è autorizzato a divertirsi. Controlla se il gioco Easter Egg nelle Impostazioni è disattivato.
autoTimeRequired
(deprecated)

boolean

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

object (PackageNameList)

Specifica i servizi di accessibilità consentiti. Se il campo non è impostato, è possibile utilizzare qualsiasi servizio di accessibilità. Se il campo è impostato, possono essere utilizzati solo i servizi di accessibilità in questo elenco e il servizio di accessibilità integrato del sistema. In particolare, se il campo è impostato su vuoto, possono essere utilizzati solo i servizi di accessibilità integrati nel sistema. Questa impostazione può essere configurata 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, che viene impostato per app e offre una maggiore flessibilità in termini di frequenza degli aggiornamenti.

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 il launcher personalizzato del kiosk è abilitato. La schermata Home viene sostituita da un launcher che blocca il dispositivo alle app installate tramite l'impostazione applications. Le app vengono visualizzate in ordine alfabetico su una sola pagina. Utilizza kioskCustomization per configurare ulteriormente il comportamento del dispositivo kiosk.
androidDevicePolicyTracks[]
(deprecated)

enum (AppTrack)

Questa impostazione non è supportata. Qualsiasi valore viene ignorato.
skipFirstUseHintsEnabled

boolean

Flag per saltare i suggerimenti al primo utilizzo. L'amministratore Enterprise può attivare il suggerimento di sistema per le app in modo da saltare il tutorial per gli utenti e altri suggerimenti introduttivi al primo avvio.
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 con versioni precedenti di Android P, l'impostazione di questa opzione potrebbe rendere vulnerabili le chiavi aziendali. Questo valore non avrà alcun effetto se un'applicazione ha un ambito di delega CERT_SELECTION.
encryptionPolicy

enum (EncryptionPolicy)

Se la crittografia è attivata
usbMassStorageEnabled
(deprecated)

boolean

Indica se l'archivio USB è abilitato. Deprecato.
permissionGrants[]

object (PermissionGrant)

Autorizzazione o concessione o rifiuto esplicito del gruppo per tutte le app. Questi valori sostituiscono defaultPermissionPolicy.
playStoreMode

enum (PlayStoreMode)

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

object (SetupAction)

L'azione da compiere durante la procedura di configurazione. Può essere specificata al massimo un'azione.
passwordPolicies[]

object (PasswordRequirements)

Criteri per i requisiti delle password. È possibile impostare criteri diversi per il profilo di lavoro o per i dispositivi completamente gestiti impostando il campo passwordScope nei criteri.
policyEnforcementRules[]

object (PolicyEnforcementRule)

Regole che definiscono il comportamento quando una determinata norma non può essere applicata 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)

Norme che gestiscono l'utilizzo personale su un dispositivo di proprietà aziendale.
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 cross-profile applicati sul dispositivo.
preferentialNetworkService

enum (PreferentialNetworkService)

Controlla se il servizio di rete preferenziale è attivato nel profilo di lavoro o sui dispositivi completamente gestiti. Ad esempio, un'organizzazione potrebbe avere un accordo con un operatore in base al quale tutti i dati di lavoro dei dispositivi dei dipendenti verranno inviati tramite un servizio di rete dedicato all'uso aziendale. Un esempio di servizio di rete preferito supportato è lo slicing aziendale sulle reti 5G. Questo criterio non ha effetto se preferentialNetworkServiceSettings o ApplicationPolicy.preferentialNetworkId è impostato sui dispositivi con Android 13 o versioni successive.
usageLog

object (UsageLog)

Configurazione della registrazione delle attività del dispositivo.
cameraAccess

enum (CameraAccess)

Controlla l'utilizzo della videocamera e se l'utente ha accesso al pulsante di attivazione/disattivazione dell'accesso alla videocamera.
microphoneAccess

enum (MicrophoneAccess)

Controlla l'utilizzo 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)

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

object (DeviceRadioState)

Copre i controlli per lo stato della radio, come Wi-Fi, Bluetooth e altro ancora.
credentialProviderPolicyDefault

enum (CredentialProviderPolicyDefault)

Controlla quali app possono fungere da fornitori di credenziali su Android 14 e versioni successive. Queste app archiviano le credenziali. Per maggiori dettagli, consulta questo e questo. 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 con privilegi, 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.
workAccountSetupConfig

object (WorkAccountSetupConfig)

(Facoltativo) Controlla la configurazione dell'account di lavoro, ad esempio i dettagli relativi alla necessità di un account autenticato da Google.
wipeDataFlags[]

enum (WipeDataFlag)

(Facoltativo) I flag di cancellazione indicano quali dati vengono cancellati quando viene attivata la cancellazione di un dispositivo o di un profilo per qualsiasi motivo (ad esempio, mancata conformità). Ciò non si applica al metodo enterprises.devices.delete. . Questo elenco non deve contenere duplicati.
enterpriseDisplayNameVisibility

enum (EnterpriseDisplayNameVisibility)

(Facoltativo) Controlla se il enterpriseDisplayName è visibile sul dispositivo (ad es. il messaggio della schermata di blocco sui dispositivi di proprietà dell'azienda).
appFunctions

enum (AppFunctions)

(Facoltativo) Controlla se le app sul dispositivo per i dispositivi completamente gestiti o nel profilo di lavoro per i dispositivi con profili di lavoro possono esporre le funzioni delle app.

ApplicationPolicy

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

Rappresentazione JSON 
{
  "packageName": string,
  "installType": enum (InstallType),
  "lockTaskAllowed": boolean,
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "managedConfiguration": {
    object
  },
  "disabled": boolean,
  "minimumVersionCode": integer,
  "delegatedScopes": [
    enum (DelegatedScope)
  ],
  "managedConfigurationTemplate": {
    object (ManagedConfigurationTemplate)
  },
  "accessibleTrackIds": [
    string
  ],
  "connectedWorkAndPersonalApp": enum (ConnectedWorkAndPersonalApp),
  "autoUpdateMode": enum (AutoUpdateMode),
  "extensionConfig": {
    object (ExtensionConfig)
  },
  "alwaysOnVpnLockdownExemption": enum (AlwaysOnVpnLockdownExemption),
  "workProfileWidgets": enum (WorkProfileWidgets),
  "credentialProviderPolicy": enum (CredentialProviderPolicy),
  "installConstraint": [
    {
      object (InstallConstraint)
    }
  ],
  "installPriority": integer,
  "userControlSettings": enum (UserControlSettings),
  "preferentialNetworkId": enum (PreferentialNetworkId)
}
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, questo criterio sostituisce defaultPermissionPolicy a livello di criterio, che si applica a tutte le app. Non sostituisce le permissionGrants, che si applicano a tutte le app.
permissionGrants[]

object (PermissionGrant)

Concessioni o negazioni esplicite di autorizzazioni 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 è determinato dai valori ManagedProperty supportati dall'app. Ogni nome campo nella configurazione gestita deve corrispondere al campo key di ManagedProperty. Il valore del campo deve essere compatibile con type di ManagedProperty:

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

boolean

Indica se l'app è disattivata. Se 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. Per ogni norma, al massimo 20 app possono specificare un codice di versione minima.
delegatedScopes[]

enum (DelegatedScope)

Gli ambiti delegati all'app da Android Device Policy. Questi 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 traccia, i dispositivi ricevono l'ultima versione tra tutte le tracce accessibili. Se l'elenco non contiene ID traccia, i dispositivi hanno accesso solo alla traccia di produzione dell'app. Maggiori dettagli su ogni traccia sono disponibili in AppTrackInfo.
connectedWorkAndPersonalApp

enum (ConnectedWorkAndPersonalApp)

Controlla se l'app può comunicare con se stessa nei profili di lavoro e personali di un dispositivo, previo consenso dell'utente.
autoUpdateMode

enum (AutoUpdateMode)

Controlla la modalità di aggiornamento automatico per l'app.
extensionConfig

object (ExtensionConfig)

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

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

Affinché l'app possa comunicare con Android Device Policy, la fingerprint del certificato della chiave di firma dell'app sul dispositivo deve corrispondere a una delle voci in signingKeyFingerprintsSha256 o alle fingerprint del certificato della chiave di firma ottenute dal Play Store. Se l'app non è sul Play Store e signingKeyFingerprintsSha256 non è impostato, viene segnalato un NonComplianceDetail con INVALID_VALUE.
alwaysOnVpnLockdownExemption

enum (AlwaysOnVpnLockdownExemption)

Specifica se l'app può accedere alla rete quando la VPN non è connessa e alwaysOnVpnPackage.lockdownEnabled è attivato. Se è impostato su VPN_LOCKDOWN_ENFORCED, l'app non può accedere alla rete, mentre se è impostato su VPN_LOCKDOWN_EXEMPTION, l'app può accedere alla 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 fieldPath. Se 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 può aggiungere widget alla schermata Home.
credentialProviderPolicy

enum (CredentialProviderPolicy)

(Facoltativo) Se l'app è autorizzata a fungere da 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:

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

enum (UserControlSettings)

(Facoltativo) Specifica se il controllo utente è consentito per l'app. Il controllo utente include azioni come l'interruzione forzata e la cancellazione dei dati dell'app. Alcuni tipi di app hanno un trattamento speciale. Per maggiori dettagli, consulta USER_CONTROL_SETTINGS_UNSPECIFIED e USER_CONTROL_ALLOWED.
preferentialNetworkId

enum (PreferentialNetworkId)

(Facoltativo) ID della rete preferenziale utilizzata dall'applicazione. Deve esistere una configurazione per l'ID rete specificato in preferentialNetworkServiceConfigs. Se impostato su PREFERENTIAL_NETWORK_ID_UNSPECIFIED, l'applicazione utilizzerà l'ID rete predefinito specificato in defaultPreferentialNetworkId. Consulta la documentazione di defaultPreferentialNetworkId per l'elenco delle app escluse da questa impostazione predefinita. Ciò vale sia per i profili di lavoro sia per i dispositivi completamente gestiti su Android 13 e versioni successive.

InstallType

Il tipo di installazione da eseguire per un'app. Se setupAction fa riferimento a un'app, deve essere impostato installType come REQUIRED_FOR_SETUP o 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 un periodo di manutenzione impostato e non può essere rimossa dall'utente.
BLOCKED L'app è bloccata e non può essere installata. Se l'app è stata installata in base a un criterio precedente, verrà disinstallata. Inoltre, blocca 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 finché l'installazione non è terminata.
KIOSK L'app viene installata automaticamente in modalità kiosk: è impostata come intent Home preferito e inserita nella lista consentita per la modalità Blocco attività. 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 installType per una sola 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 Richiedere all'utente di concedere un'autorizzazione.
GRANT

Concedere automaticamente un'autorizzazione.

Su Android 12 e versioni successive, READ_SMS e le seguenti autorizzazioni relative ai sensori possono essere concesse solo su dispositivi completamente gestiti:
DENY Negare automaticamente un'autorizzazione.

PermissionGrant

Configurazione di un'autorizzazione Android e 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. Questi 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 al blocco della disinstallazione. Questo ambito può essere delegato a più applicazioni.
PERMISSION_GRANT Concede l'accesso alla policy delle autorizzazioni e allo stato della 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 con 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 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 Consente l'accesso alla selezione dei certificati KeyChain per conto delle app richiedenti. Una volta concesso, 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 dei certificati viene delegata a un'applicazione.

ManagedConfigurationTemplate

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

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

string

L'ID del modello di configurazioni gestite.
configurationVariables

map (key: string, value: string)

(Facoltativo) Una mappa contenente le variabili di configurazione <chiave, valore> 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 i profili, previo 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 i profili dopo aver ricevuto il consenso dell'utente.

AutoUpdateMode

Controlla la modalità di aggiornamento automatico per l'app. Se un utente del dispositivo apporta modifiche manualmente alle impostazioni del dispositivo, queste scelte vengono ignorate da AutoUpdateMode, che ha la precedenza.

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

La modalità di aggiornamento predefinita.

L'app viene aggiornata automaticamente con 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 limiti.
  • Il dispositivo è in carica.
  • L'app da aggiornare non è in esecuzione in primo piano.

Il dispositivo riceve una notifica relativa a un nuovo aggiornamento entro 24 ore dalla pubblicazione da parte dello sviluppatore, dopodiché l'app viene aggiornata la volta successiva che vengono rispettati i vincoli sopra indicati.
AUTO_UPDATE_POSTPONED

L'app non viene aggiornata automaticamente per un massimo di 90 giorni da quando diventa obsoleta.

90 giorni dopo che l'app diventa obsoleta, viene installata automaticamente l'ultima versione 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 viene informato il prima possibile di un nuovo aggiornamento non appena questo diventa disponibile.

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

ExtensionConfig

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

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

string

Hash SHA-256 con codifica esadecimale dei certificati della chiave di firma dell'app di estensione. Sono valide solo le rappresentazioni di stringhe esadecimali di 64 caratteri.

Le impronte dei certificati della chiave di firma vengono sempre ottenute dal Play Store e questo campo viene utilizzato per fornire impronte aggiuntive dei certificati della chiave di firma. Tuttavia, se l'applicazione non è disponibile sul Play Store, questo campo deve essere impostato. Viene segnalato un NonComplianceDetail con INVALID_VALUE se questo campo non è impostato quando l'applicazione non è disponibile sul Play Store.

La fingerprint del certificato della chiave di firma dell'app di estensione sul dispositivo deve corrispondere a una delle fingerprint del certificato della chiave di firma ottenute dal Play Store o a quelle fornite in questo campo affinché l'app possa comunicare con Android Device Policy.

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

string

Nome della classe completo del servizio ricevitore per Android Device Policy per notificare all'app di estensione eventuali aggiornamenti dello stato dei comandi locali. Il servizio deve essere esportato in AndroidManifest.xml dell'app di estensione ed estendere NotificationReceiverService (per maggiori dettagli, consulta la guida Eseguire l'integrazione con l'SDK AMAPI).

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 può aggiungere widget alla schermata Home.

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

CredentialProviderPolicy

Se l'app è autorizzata a fungere da 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 può fungere da fornitore di credenziali.

InstallConstraint

Tra le app con InstallType impostato su:

definisce un insieme di limitazioni per l'installazione dell'app. È necessario impostare almeno uno dei campi. Quando vengono impostati più campi, tutti i vincoli devono essere 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) Vincolo di ricarica.
deviceIdleConstraint

enum (DeviceIdleConstraint)

(Facoltativo) Vincolo di inattività del dispositivo.

NetworkTypeConstraint

Vincolo del tipo di rete.

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

ChargingConstraint

Vincolo 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

Vincolo 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 dell'utente come l'interruzione forzata e la cancellazione dei dati dell'app.

Enum
USER_CONTROL_SETTINGS_UNSPECIFIED

Utilizza il comportamento predefinito dell'app per determinare se il controllo utente è consentito o non consentito. Il controllo utente è consentito per impostazione predefinita per la maggior parte delle app, ma non per i seguenti tipi di app:

  • app di estensione (vedi extensionConfig per maggiori dettagli)
  • app kiosk (per maggiori dettagli, vedi il tipo di installazione KIOSK)
  • altre app di sistema critiche
USER_CONTROL_ALLOWED Il controllo utente è consentito per l'app. Le app kiosk possono utilizzarlo per consentire il controllo utente. Per le app di estensione (vedi extensionConfig per maggiori dettagli), il controllo utente non è consentito anche se questo valore è impostato. Per le app kiosk (vedi il tipo di installazione KIOSK per maggiori dettagli), questo valore può essere utilizzato per consentire il controllo da parte dell'utente.
USER_CONTROL_DISALLOWED Il controllo utente non è consentito per l'app. Questa funzionalità è supportata su Android 11 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 11.

PreferentialNetworkId

Identificatore di rete preferenziale.

Enum
PREFERENTIAL_NETWORK_ID_UNSPECIFIED La validità e il significato di questo valore dipendono dal contesto in cui viene utilizzato e sono documentati nei campi pertinenti.
NO_PREFERENTIAL_NETWORK L'applicazione non utilizza alcuna rete preferenziale.
PREFERENTIAL_NETWORK_ID_ONE Identificatore di rete preferenziale 1.
PREFERENTIAL_NETWORK_ID_TWO Identificatore di rete preferenziale 2.
PREFERENTIAL_NETWORK_ID_THREE Identificatore di rete preferenziale 3.
PREFERENTIAL_NETWORK_ID_FOUR Identificatore di rete preferenziale 4.
PREFERENTIAL_NETWORK_ID_FIVE Identificatore di rete preferenziale 5.

KeyguardDisabledFeature

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

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

PersistentPreferredActivity

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

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

string

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

string

Le azioni intent da corrispondere nel filtro. Se nel filtro sono incluse delle azioni, l'azione di un intent deve corrispondere a uno di questi valori. Se non sono incluse azioni, l'azione di intent viene ignorata.
categories[]

string

Le categorie di intent da corrispondere nel filtro. Un intent include le categorie richieste, che devono essere tutte 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 Mainline in Gestire gli aggiornamenti di sistema.

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

enum (SystemUpdateType)

Il tipo di aggiornamento di sistema da configurare.
startMinutes

integer

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

integer

Se il tipo è WINDOWED, la fine del periodo di manutenzione, misurata come il numero di minuti dopo 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 fino a mezzanotte. Se il periodo di manutenzione specificato è inferiore a 30 minuti, il periodo effettivo viene esteso a 30 minuti oltre l'ora di inizio.
freezePeriods[]

object (FreezePeriod)

Un periodo di tempo che si ripete ogni anno in cui gli aggiornamenti di sistema OTA (over-the-air) vengono posticipati per bloccare la versione del sistema operativo in esecuzione su un dispositivo. Per evitare il blocco del 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 per il dispositivo, che in genere richiede all'utente di accettare gli aggiornamenti di sistema.
AUTOMATIC Verrà installato automaticamente non appena sarà disponibile un aggiornamento.
WINDOWED

Installare automaticamente entro un periodo di manutenzione giornaliera. In questo modo, le app Google Play vengono aggiornate all'interno della finestra. Questa operazione è 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 Google Play.

Se autoUpdateMode è impostato su AUTO_UPDATE_HIGH_PRIORITY per un'app, il periodo di manutenzione viene ignorato per l'app e questa viene aggiornata 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 es. le patch di sicurezza mensili).

FreezePeriod

Un periodo di blocco del sistema. Quando l'orologio di un dispositivo rientra nel periodo di blocco, tutti gli aggiornamenti di sistema in arrivo (incluse le patch di sicurezza) vengono bloccati e non vengono 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 fine di un periodo di sospensione, il periodo di sospensione 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 di un periodo di sospensione o il tempo che intercorre tra due periodi di sospensione, il 29 febbraio viene ignorato e non viene conteggiato come giorno.

Nota: affinché i periodi di blocco abbiano effetto, SystemUpdateType non può essere specificato come SYSTEM_UPDATE_TYPE_UNSPECIFIED, perché i periodi di blocco richiedono che venga specificata una policy definita.

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

object (Date)

La data di inizio (inclusa) del periodo di blocco. Nota: è necessario impostare day e month. year non deve essere impostato perché non viene utilizzato. 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 a cavallo tra due anni. Nota: è necessario impostare day e month. year non deve essere impostato perché non viene utilizzato. 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 sono irrilevanti. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • 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

L'anno della data. Deve essere compreso tra 1 e 9999 o tra 0 e 9999 per specificare una data senza anno.
month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 o 0 per specificare un anno senza mese e giorno.
day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure compreso tra 0 e 31 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 la generazione di report sulle impostazioni del dispositivo è attivata.
softwareInfoEnabled

boolean

Se il reporting delle informazioni sul software è attivato.
memoryInfoEnabled

boolean

Indica se è attivato il reporting degli eventi di memoria.
networkInfoEnabled

boolean

Se il report sulle informazioni sulla rete è attivato.
displayInfoEnabled

boolean

Se è attivato il reporting delle visualizzazioni. I dati dei report non sono disponibili per i dispositivi di proprietà personale con profili di lavoro.
powerManagementEventsEnabled

boolean

Indica se è attivato il reporting degli eventi di gestione dell'alimentazione. 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 dei report dell'applicazione. Applicabile solo se applicationReportsEnabled è true.
commonCriteriaModeEnabled

boolean

Indica se il reporting di Common Criteria Mode è attivato. Questa funzionalità è supportata solo sui dispositivi di proprietà dell'azienda.

ApplicationReportingSettings

Impostazioni che controllano il comportamento dei report delle applicazioni.

Rappresentazione JSON 
{
  "includeRemovedApps": boolean
}
Campi
includeRemovedApps

boolean

Se le app rimosse sono incluse nei report sulle applicazioni.

PackageNameList

Un elenco di nomi di pacchetti.

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

string

Un elenco di nomi di pacchetti.

BatteryPluggedMode

Modalità di collegamento della batteria.

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

ProxyInfo

Informazioni di configurazione per un proxy HTTP. Per un proxy diretto, imposta i campi host, port e excludedHosts. Per un proxy con 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, Android Device Policy concede all'app specificata. L'accesso viene concesso quando l'app chiama KeyChain.choosePrivateKeyAlias (o qualsiasi overload) per richiedere un alias di chiave privata per un determinato URL oppure, per le regole non specifiche per l'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 se corrisponde più di un choosePrivateKeyRules, l'ultima regola corrispondente definisce quale alias della 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. Utilizza la sintassi delle espressioni regolari di java.util.regex.Pattern.
packageNames[]

string

I nomi dei pacchetti a cui si applica questa regola. L'hash del certificato di firma per ogni app viene verificato rispetto 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 qualsiasi overload (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

Non consente il networking quando la VPN non è connessa.

LocationMode

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

Enum
LOCATION_MODE_UNSPECIFIED Il valore predefinito è LOCATION_USER_CHOICE.
HIGH_ACCURACY

Su Android 8 e versioni precedenti, tutti i metodi di rilevamento della posizione sono abilitati, inclusi GPS, reti e altri sensori. Su Android 9 e versioni successive, questa impostazione equivale a LOCATION_ENFORCED.
SENSORS_ONLY

Su Android 8 e versioni precedenti, sono attivi solo il GPS e altri sensori. Su Android 9 e versioni successive, questa impostazione equivale a LOCATION_ENFORCED.
BATTERY_SAVING

Su Android 8 e versioni precedenti, è abilitato solo il provider di localizzazione di rete. Su Android 9 e versioni successive, questa impostazione equivale a LOCATION_ENFORCED.
OFF

Su Android 8 e versioni precedenti, l'impostazione e la precisione della localizzazione sono disattivate. Su Android 9 e versioni successive, questa impostazione equivale a LOCATION_DISABLED.
LOCATION_USER_CHOICE L'impostazione della posizione non è limitata sul dispositivo. Nessun comportamento specifico è impostato o applicato.
LOCATION_ENFORCED Attiva l'impostazione di geolocalizzazione sul dispositivo.
LOCATION_DISABLED Disattiva l'impostazione della posizione sul dispositivo.

ComplianceRule

Una regola che dichiara quali azioni di mitigazione intraprendere quando un dispositivo non è conforme al criterio. Per ogni regola, esiste sempre un'azione di mitigazione implicita per impostare policyCompliant su false per la risorsa Device e visualizzare un messaggio sul dispositivo che indica che non è conforme alla sua policy. A seconda dei valori dei campi nella regola, possono essere intraprese anche altre azioni di mitigazione facoltative.

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 vengono conservati. Se il dispositivo esegue un'app in modalità 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. Questo è il 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 è impostata, questa condizione corrisponde a qualsiasi motivo.
packageName

string

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

ApiLevelCondition

Una condizione della regola di conformità soddisfatta se il livello API del framework Android sul dispositivo non soddisfa un requisito minimo. Per ogni criterio può esistere una sola regola con questo tipo di condizione.

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, che viene impostato per app e offre una maggiore flessibilità in termini di frequenza degli aggiornamenti.

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 gruppo release dell'app Google Play.

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

EncryptionPolicy

Tipo di crittografia

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

PlayStoreMode

Valori possibili per il criterio della modalità Play Store.

Enum
PLAY_STORE_MODE_UNSPECIFIED Non specificato. Il valore predefinito è WHITELIST.
WHITELIST Sono disponibili solo le app incluse nel criterio e qualsiasi app non inclusa nel criterio verrà disinstallata automaticamente dal dispositivo.
BLACKLIST Tutte le app sono disponibili e qualsiasi app che non deve essere presente 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 intent contenente un extra con la chiave com.google.android.apps.work.clouddpc.EXTRA_LAUNCHED_AS_SETUP_ACTION impostata sul valore booleano true per indicare che si tratta di un flusso di azioni di configurazione. Se SetupAction fa riferimento a un'app, il installType corrispondente nelle norme relative alle applicazioni 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 avvio da eseguire launch può essere solo una delle seguenti:
packageName

string

Nome del pacchetto dell'app da avviare

PolicyEnforcementRule

Una regola che definisce le azioni da intraprendere se un dispositivo o un profilo di lavoro non è conforme al criterio specificato in settingName. In caso di più regole di applicazione corrispondenti o attivate, verrà eseguita un'unione e verrà intrapresa l'azione più grave. Tuttavia, tutte le regole attivate vengono comunque monitorate, 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 più appropriata successiva.

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

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

object (BlockAction)

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

object (WipeAction)

Un'azione per ripristinare 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

La norma 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 visualizzare una notifica rivolta all'utente con informazioni (ove 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. Valido solo per i dispositivi di proprietà dell'azienda.

BlockScope

Specifica l'ambito di BlockAction. Valido solo per i 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 ripristinare 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 non conformità alle norme prima della cancellazione dei dati del dispositivo o del profilo di lavoro. wipeAfterDays deve essere maggiore di blockAfterDays.
preserveFrp

boolean

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 a lungo 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 che non rispondono sono bloccate in modalità kiosk. Se bloccato, il sistema interromperà forzatamente l'app come se l'utente scegliesse l'opzione "Chiudi app" nell'interfaccia utente.
systemNavigation

enum (SystemNavigation)

Specifica quali funzionalità di navigazione sono attive (ad es. pulsanti Home e Panoramica) in modalità kiosk.
statusBar

enum (StatusBar)

Specifica se le informazioni di sistema e le notifiche 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 a lungo il tasto di accensione.

Enum
POWER_BUTTON_ACTIONS_UNSPECIFIED 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 che non rispondono sono bloccate in modalità kiosk.

Enum
SYSTEM_ERROR_WARNINGS_UNSPECIFIED Non specificato, il valore predefinito è ERROR_AND_WARNINGS_MUTED.
ERROR_AND_WARNINGS_ENABLED Vengono visualizzate tutte le finestre di dialogo di errore di sistema, ad esempio arresti anomali e L'applicazione non risponde (ANR).
ERROR_AND_WARNINGS_MUTED Tutte le finestre di dialogo di errore di sistema, come arresti anomali e L'applicazione non risponde (ANR), vengono bloccate. Quando è bloccata, il sistema arresta forzatamente l'app come se l'utente la chiudesse dall'interfaccia utente.

SystemNavigation

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

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

StatusBar

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

Enum
STATUS_BAR_UNSPECIFIED 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 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)

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

enum (GooglePlayProtectVerifyApps)

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

enum (DeveloperSettings)

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

enum (CommonCriteriaMode)

Modalità Common Criteria per i controlli: standard di sicurezza definiti nei Common Criteria for Information Technology Security Evaluation (CC). L'attivazione della modalità Common Criteria aumenta determinati 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. Attivato solo se necessario. Se la modalità Common Criteria viene disattivata dopo essere stata abilitata in precedenza, tutte le reti Wi-Fi configurate dall'utente potrebbero essere perse e tutte le reti Wi-Fi configurate dall'azienda che richiedono l'input dell'utente potrebbero dover essere riconfigurate.
personalAppsThatCanReadWorkNotifications[]

string

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

enum (MtePolicy)

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

enum (ContentProtectionPolicy)

(Facoltativo) Controlla se è attiva la protezione dei contenuti, che esegue la scansione delle app ingannevoli. Questa funzionalità è supportata su Android 15 e versioni successive.

UntrustedAppsPolicy

Il criterio per le app non attendibili (app di origini sconosciute) applicato 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 l'installazione 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

Indica se è applicata la 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. Forza l'attivazione della 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 (deprecato) e debuggingFeaturesAllowed (deprecato).

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

CommonCriteriaMode

Modalità Common Criteria per i controlli: standard di sicurezza definiti nei Common Criteria for Information Technology Security Evaluation (CC). L'attivazione della modalità Common Criteria aumenta determinati componenti di sicurezza su un dispositivo, tra cui:

  1. Crittografia AES-GCM delle chiavi a lungo termine Bluetooth
  2. Negozi di configurazione Wi-Fi
  3. Convalida di certificati di rete aggiuntivi che richiede l'utilizzo di TLSv1.2 per connettersi agli host di destinazione dell'API AM
  4. Controllo dell'integrità delle norme di crittografia. 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à aziendale 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. Attivato solo se necessario. Se la modalità Common Criteria viene disattivata dopo essere stata abilitata in precedenza, tutte le reti Wi-Fi configurate dall'utente potrebbero essere perse e tutte le reti Wi-Fi configurate dall'azienda che richiedono l'input dell'utente potrebbero dover essere riconfigurate.

Enum
COMMON_CRITERIA_MODE_UNSPECIFIED Non specificato. Il valore predefinito è COMMON_CRITERIA_MODE_DISABLED.
COMMON_CRITERIA_MODE_DISABLED Predefinita. Disattiva la modalità Common Criteria.
COMMON_CRITERIA_MODE_ENABLED Attiva la modalità Common Criteria.

MtePolicy

Controlla Memory Tagging Extension (MTE) sul dispositivo.

Enum
MTE_POLICY_UNSPECIFIED Non specificato. Il valore predefinito è MTE_USER_CHOICE.
MTE_USER_CHOICE L'utente può scegliere di attivare o disattivare MTE sul dispositivo, se supportato.
MTE_ENFORCED

MTE è attivato sul dispositivo e l'utente non può modificare questa impostazione. Questa impostazione può essere configurata sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà aziendale. 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

MTE è disattivato sul dispositivo e l'utente non può 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 è attiva la protezione dei contenuti, che esegue la scansione delle app ingannevoli. 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à aziendale con un profilo di lavoro.

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

boolean

Se è true, la videocamera è disattivata nel profilo personale.
screenCaptureDisabled

boolean

Se è impostato su true, l'acquisizione 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à viene 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 inattività, puoi impostare temporaneamente un valore elevato per questo parametro.
personalPlayStoreMode

enum (PlayStoreMode)

Utilizzato insieme a personalApplications per controllare come le app nel profilo personale sono consentite o bloccate.
personalApplications[]

object (PersonalApplicationPolicy)

Norme applicate alle applicazioni nel profilo personale.
privateSpacePolicy

enum (PrivateSpacePolicy)

(Facoltativo) Controlla se è consentito uno spazio privato sul dispositivo.
bluetoothSharing

enum (BluetoothSharing)

(Facoltativo) Indica se la condivisione Bluetooth è consentita.

PlayStoreMode

Utilizzato insieme a personalApplications per controllare come le app nel profilo personale sono 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, ad eccezione di quelle il cui installType è BLOCKED in personalApplications.
BLOCKLIST Tutte le app del Play Store sono disponibili per l'installazione nel profilo personale, ad eccezione di quelle il cui installType è BLOCKED in personalApplications.
ALLOWLIST Solo le app specificate esplicitamente in personalApplications con installType impostato su AVAILABLE possono essere installate nel profilo personale.

PersonalApplicationPolicy

Norme per le app nel profilo personale di un dispositivo di proprietà aziendale 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 può avere un'applicazione del profilo personale.

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

PrivateSpacePolicy

Controlla se è consentito uno spazio privato sul dispositivo.

Enum
PRIVATE_SPACE_POLICY_UNSPECIFIED Non specificato. Il valore predefinito è PRIVATE_SPACE_ALLOWED.
PRIVATE_SPACE_ALLOWED Gli utenti possono creare un profilo dello spazio privato.
PRIVATE_SPACE_DISALLOWED Gli utenti non possono creare un profilo dello spazio privato. Supportato solo per i dispositivi di proprietà dell'azienda con un profilo di lavoro. Attenzione: tutti gli spazi privati esistenti verranno rimossi.

BluetoothSharing

Indica se la condivisione Bluetooth è consentita nel profilo personale di un dispositivo di proprietà dell'azienda con un profilo di lavoro.

Enum
BLUETOOTH_SHARING_UNSPECIFIED Non specificato. Il valore predefinito è BLUETOOTH_SHARING_ALLOWED.
BLUETOOTH_SHARING_ALLOWED

La condivisione Bluetooth è consentita sul profilo personale.

Supportata su Android 8 e versioni successive. Se questa impostazione è configurata per un dispositivo personale, viene segnalato un NonComplianceDetail con MANAGEMENT_MODE.
BLUETOOTH_SHARING_DISALLOWED

La condivisione Bluetooth non è consentita nel profilo personale.

Supportata su Android 8 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 8. Se questa impostazione è configurata per un dispositivo personale, viene segnalato un NonComplianceDetail con MANAGEMENT_MODE.

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 vengono lasciati a scelta dell'utente.
AUTO_DATE_AND_TIME_ZONE_ENFORCED Imponi la data, l'ora e il fuso orario automatici sul dispositivo.

OncCertificateProvider

Questa funzionalità non è disponibile a livello generale.

Rappresentazione JSON 
{
  "certificateReferences": [
    string
  ],

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

string

Questa funzionalità non è disponibile a livello generale.

Campo unione endpoint.

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

object (ContentProviderEndpoint)

Questa funzionalità non è disponibile a livello generale.

ContentProviderEndpoint

Questa funzionalità non è disponibile a livello generale.

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

string

Questa funzionalità non è disponibile a livello generale.
packageName

string

Questa funzionalità non è disponibile a livello generale.
signingCertsSha256[]

string

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

CrossProfilePolicies

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

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

enum (ShowWorkContactsInPersonalProfile)

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

Vedi anche exemptionsToShowWorkContactsInPersonalProfile.
crossProfileCopyPaste

enum (CrossProfileCopyPaste)

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

enum (CrossProfileDataSharing)

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 di contatti, il 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.
crossProfileAppFunctions

enum (CrossProfileAppFunctions)

(Facoltativo) Controlla se le app del profilo personale possono richiamare le funzioni delle app esposte dalle app nel profilo di lavoro.
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 utilizzato da un'app personale, non è garantito 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.

Quando questa impostazione è configurata, le app personali specificate in exemptionsToShowWorkContactsInPersonalProfile vengono inserite 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 impostazione è configurata, 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 di 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é altre app di sistema o installate su Google Play potranno eseguire query direttamente sui contatti di lavoro.

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

Supportato su Android 14 e versioni successive. Se questa impostazione viene configurata 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

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 il testo copiato dal profilo di lavoro può essere incollato nel profilo di lavoro.
CROSS_PROFILE_COPY_PASTE_ALLOWED Il testo copiato in un profilo può essere incollato nell'altro.

CrossProfileDataSharing

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. Ciò include azioni come l'apertura di un browser web, l'apertura di una mappa, la condivisione di contenuti, l'apertura di un documento e così via. La gestione di altri canali di comunicazione cross-profilo, come la ricerca di contatti, il 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 viceversa.
DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED Predefinita. Impedisce agli utenti di condividere dati dal profilo di lavoro alle app nel profilo personale. I dati personali possono essere condivisi con le app di lavoro.
CROSS_PROFILE_DATA_SHARING_ALLOWED I dati di un profilo possono essere condivisi con l'altro.

WorkProfileWidgetsDefault

Controlla se le applicazioni del profilo di lavoro possono aggiungere widget alla schermata Home, dove non sono definiti criteri specifici per le app. In caso contrario, i criteri specifici dell'app avranno 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, quest'ultima potrà aggiungere widget alla schermata Home.
WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED I widget del profilo di lavoro non sono consentiti per impostazione predefinita. Ciò significa che se il criterio non specifica workProfileWidgets come WORK_PROFILE_WIDGETS_ALLOWED per l'applicazione, non sarà possibile aggiungere widget alla schermata Home.

CrossProfileAppFunctions

Controlla se le app del profilo personale possono richiamare le funzioni delle app esposte dalle app nel profilo di lavoro.

Enum
CROSS_PROFILE_APP_FUNCTIONS_UNSPECIFIED Non specificato. Se appFunctions è impostato su APP_FUNCTIONS_ALLOWED, il valore predefinito è CROSS_PROFILE_APP_FUNCTIONS_ALLOWED. Se appFunctions è impostato su APP_FUNCTIONS_DISALLOWED, il valore predefinito è CROSS_PROFILE_APP_FUNCTIONS_DISALLOWED.
CROSS_PROFILE_APP_FUNCTIONS_DISALLOWED Le app del profilo personale non possono richiamare le funzioni delle app esposte dalle app nel profilo di lavoro.
CROSS_PROFILE_APP_FUNCTIONS_ALLOWED Le app del profilo personale possono richiamare le funzioni delle app esposte dalle app nel profilo di lavoro. Se questo criterio è impostato, appFunctions non deve essere impostato su APP_FUNCTIONS_DISALLOWED, altrimenti il criterio verrà rifiutato.

PreferentialNetworkService

Controlla se il servizio di rete preferenziale è attivato nel profilo di lavoro o sui dispositivi completamente gestiti. 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 è attivato nel profilo di lavoro. Questa impostazione è supportata solo sui profili di lavoro sui dispositivi con Android 12 o versioni successive. A partire da Android 13, sono supportati anche i dispositivi completamente gestiti.

UsageLog

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

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

enum (LogType)

Specifica i tipi di log attivati. Tieni presente che gli utenti riceveranno messaggi sul dispositivo quando la registrazione dell'utilizzo è attiva.
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 segnalati 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 quando viene montato un supporto di archiviazione rimovibile. Per una descrizione completa degli eventi di sicurezza registrati, vedi UsageLogEvent. Supportato per i dispositivi completamente gestiti con Android 7 e versioni successive. Supportato per i dispositivi di proprietà aziendale con un profilo di lavoro su Android 12 e versioni successive, su cui vengono registrati solo gli eventi di sicurezza del profilo di lavoro. Può essere sostituito dall'ambito delegato dell'applicazione SECURITY_LOGS
NETWORK_ACTIVITY_LOGS Abilita il logging degli eventi di rete sul dispositivo, come le ricerche DNS e le connessioni TCP. Per una descrizione completa degli eventi di rete registrati, vedi UsageLogEvent. 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 sostituito dall'ambito delegato dell'applicazione NETWORK_ACTIVITY_LOGS

CameraAccess

Controlla l'utilizzo della videocamera e se l'utente ha accesso al pulsante di attivazione/disattivazione dell'accesso alla videocamera. Il pulsante 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 il pulsante di attivazione/disattivazione dell'accesso alla videocamera si applica solo ai dispositivi completamente gestiti, nel qual caso si applica a livello di dispositivo. Per i dettagli, consulta i valori enum.

Enum
CAMERA_ACCESS_UNSPECIFIED Se cameraDisabled è true, questa condizione equivale a CAMERA_ACCESS_DISABLED. In caso contrario, equivale a CAMERA_ACCESS_USER_CHOICE.
CAMERA_ACCESS_USER_CHOICE Il campo cameraDisabled viene ignorato. Questo è il comportamento predefinito del dispositivo: tutte le videocamere sul 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 sul dispositivo sono disattivate (per i dispositivi completamente gestiti, questa impostazione si applica a tutto il dispositivo, mentre per i profili di lavoro si applica solo al profilo di lavoro).

Non sono presenti restrizioni esplicite per l'attivazione/disattivazione dell'accesso alla fotocamera su Android 12 e versioni successive: sui dispositivi completamente gestiti, l'attivazione/disattivazione dell'accesso alla fotocamera non ha effetto perché tutte le fotocamere sono disattivate. Sui dispositivi con un profilo di lavoro, questo pulsante non ha effetto sulle app nel profilo di lavoro, ma influisce sulle app esterne al profilo di lavoro.
CAMERA_ACCESS_ENFORCED Il campo cameraDisabled viene ignorato. Tutte le videocamere sul dispositivo sono disponibili. Sui dispositivi completamente gestiti con Android 12 e versioni successive, l'utente non può utilizzare il pulsante di attivazione/disattivazione dell'accesso alla fotocamera. Sui dispositivi non completamente gestiti o con Android 11 o versioni precedenti, questa impostazione equivale 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 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, questa condizione equivale a MICROPHONE_ACCESS_DISABLED. In caso contrario, equivale a MICROPHONE_ACCESS_USER_CHOICE.
MICROPHONE_ACCESS_USER_CHOICE Il campo unmuteMicrophoneDisabled viene ignorato. Questo è il comportamento predefinito del dispositivo: il microfono sul dispositivo è disponibile. Su Android 12 e versioni successive, l'utente può utilizzare il pulsante 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, questa impostazione viene applicata a livello di dispositivo).

Il pulsante di attivazione/disattivazione dell'accesso al microfono non ha 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 può utilizzare il pulsante di attivazione/disattivazione dell'accesso al microfono. Sui dispositivi con Android 11 o versioni precedenti, questa impostazione equivale a MICROPHONE_ACCESS_USER_CHOICE.

DeviceConnectivityManagement

Include i controlli per la connettività del dispositivo, 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)
  },
  "bluetoothSharing": enum (BluetoothSharing),
  "preferentialNetworkServiceSettings": {
    object (PreferentialNetworkServiceSettings)
  },
  "apnPolicy": {
    object (ApnPolicy)
  }
}
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à il controllo completo, limitato o nullo nella 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 di tethering. In base al valore impostato, all'utente è vietato parzialmente o totalmente l'utilizzo di diverse forme di tethering.
wifiSsidPolicy

object (WifiSsidPolicy)

Limitazioni relative agli SSID Wi-Fi a cui il dispositivo può connettersi. Tieni presente che questa impostazione 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 di roaming Wi-Fi.
bluetoothSharing

enum (BluetoothSharing)

(Facoltativo) Controlla se la condivisione Bluetooth è consentita.
preferentialNetworkServiceSettings

object (PreferentialNetworkServiceSettings)

(Facoltativo) Configurazione del servizio di rete preferito. L'impostazione di questo campo sostituirà preferentialNetworkService. Questa impostazione può essere configurata sia sui profili di lavoro sia sui dispositivi completamente gestiti su Android 13 e versioni successive. Per maggiori dettagli, consulta la guida Sezionamento della rete 5G.
apnPolicy

object (ApnPolicy)

(Facoltativo) Policy del nome punto di accesso (APN). Configurazione per i nomi punti di accesso (APN) che possono eseguire l'override di qualsiasi altro APN sul dispositivo. Per i dettagli, consulta OVERRIDE_APNS_ENABLED e overrideApns.

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, come la connessione di mouse e tastiera. usbFileTransferDisabled viene ignorato.
DISALLOW_USB_DATA_TRANSFER Se impostata, tutti i tipi di trasferimenti di dati USB sono vietati. Supportato per i dispositivi con Android 12 o versioni successive con USB HAL 1.3 o versioni successive. Se l'impostazione non è supportata, verrà impostata la variabile 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 ha USB HAL 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à il controllo completo, limitato o nullo della configurazione delle reti Wi-Fi.

Enum
CONFIGURE_WIFI_UNSPECIFIED Non specificato. Il valore predefinito è ALLOW_CONFIGURING_WIFI, a meno che wifiConfigDisabled non sia impostato su true. Se wifiConfigDisabled è impostato su true, equivale a DISALLOW_CONFIGURING_WIFI.
ALLOW_CONFIGURING_WIFI L'utente è 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, sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà aziendale. Se l'impostazione non è supportata, viene impostata la variabile 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 questo valore è impostato. Supportato su dispositivi completamente gestiti e profili di lavoro su dispositivi di proprietà dell'azienda, su tutti i livelli API supportati. Per i dispositivi completamente gestiti, questa impostazione rimuove tutte le reti configurate e mantiene solo le reti 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 visualizzato il meccanismo di escape della rete per aggiornare i criteri del dispositivo (vedi networkEscapeHatchEnabled).

WifiDirectSettings

Controlla le impostazioni di 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 Wi-Fi Direct.
DISALLOW_WIFI_DIRECT L'utente non è autorizzato a utilizzare 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, equivale a DISALLOW_ALL_TETHERING.
ALLOW_ALL_TETHERING Consente la configurazione e l'utilizzo di tutte le forme di tethering. tetheringConfigDisabled viene ignorato.
DISALLOW_WIFI_TETHERING Impedisce all'utente di utilizzare il tethering Wi-Fi. Funzionalità supportata sui dispositivi di proprietà dell'azienda con Android 13 e versioni successive. Se l'impostazione non è supportata, verrà impostata la variabile 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 consente 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

Limitazioni relative agli SSID Wi-Fi a cui il dispositivo può connettersi. Tieni presente che questa impostazione 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 norma SSID Wi-Fi da applicare.
wifiSsids[]

object (WifiSsid)

(Facoltativo) Elenco degli SSID Wi-Fi da applicare nella norma. Questo campo non deve essere vuoto quando WifiSsidPolicyType è impostato su WIFI_SSID_ALLOWLIST. Se questo criterio è impostato su un elenco non vuoto, viene segnalato 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à aziendale.

WifiSsidPolicyType

I tipi di criteri SSID Wi-Fi che possono essere applicati sul 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 il dispositivo può connettersi.
WIFI_SSID_DENYLIST Il dispositivo non può connettersi a nessuna rete Wi-Fi il cui SSID è in wifiSsids, ma può connettersi ad altre reti.
WIFI_SSID_ALLOWLIST Il dispositivo può stabilire connessioni Wi-Fi solo con gli 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 Wi-Fi rappresentato come stringa.

WifiRoamingPolicy

Norme di roaming Wi-Fi.

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

object (WifiRoamingSetting)

(Facoltativo) Impostazioni di 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_DISABLED Il roaming Wi-Fi è disattivato. Supportato su Android 15 e versioni successive sui dispositivi completamente gestiti e sui profili di lavoro sui dispositivi di proprietà aziendale. 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.
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à aziendale. 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.

BluetoothSharing

Controlla se la condivisione Bluetooth è consentita.

Enum
BLUETOOTH_SHARING_UNSPECIFIED Non specificato. Il valore predefinito è BLUETOOTH_SHARING_DISALLOWED sui profili di lavoro e BLUETOOTH_SHARING_ALLOWED sui dispositivi completamente gestiti.
BLUETOOTH_SHARING_ALLOWED

La condivisione Bluetooth è consentita.

Supportata su Android 8 e versioni successive. Un NonComplianceDetail con API_LEVEL viene segnalato nei profili di lavoro se la versione di Android è precedente alla 8.
BLUETOOTH_SHARING_DISALLOWED

La condivisione Bluetooth non è consentita.

Supportata su Android 8 e versioni successive. Un NonComplianceDetail con API_LEVEL viene segnalato sui dispositivi completamente gestiti se la versione di Android è precedente alla 8.

PreferentialNetworkServiceSettings

Impostazioni del servizio di rete preferito.

Rappresentazione JSON 
{
  "preferentialNetworkServiceConfigs": [
    {
      object (PreferentialNetworkServiceConfig)
    }
  ],
  "defaultPreferentialNetworkId": enum (PreferentialNetworkId)
}
Campi
preferentialNetworkServiceConfigs[]

object (PreferentialNetworkServiceConfig)

Obbligatorio. Configurazioni preferenziali dei servizi di rete che consentono di avere più sezioni aziendali. Non devono esistere più configurazioni con lo stesso preferentialNetworkId. Se una configurazione non viene referenziata da alcuna applicazione impostando ApplicationPolicy.preferentialNetworkId o defaultPreferentialNetworkId, verrà ignorata. Per i dispositivi sulle reti 4G, è necessario configurare l'APN aziendale per impostare la chiamata dati per il servizio di rete preferenziale. Questi APN possono essere aggiunti utilizzando apnPolicy.
defaultPreferentialNetworkId

enum (PreferentialNetworkId)

Obbligatorio. ID rete preferenziale predefinito per le applicazioni che non si trovano in applications o se ApplicationPolicy.preferentialNetworkId è impostato su PREFERENTIAL_NETWORK_ID_UNSPECIFIED. Deve esistere una configurazione per l'ID di rete specificato in preferentialNetworkServiceConfigs, a meno che non sia impostato su NO_PREFERENTIAL_NETWORK. Se impostato su PREFERENTIAL_NETWORK_ID_UNSPECIFIED o non impostato, il valore predefinito è NO_PREFERENTIAL_NETWORK. Nota: se la rete preferenziale predefinita è configurata in modo errato, le applicazioni senza ApplicationPolicy.preferentialNetworkId impostato non sono in grado di accedere a internet. Questa impostazione non si applica alle seguenti app critiche:

  • com.google.android.apps.work.clouddpc
  • com.google.android.gms

ApplicationPolicy.preferentialNetworkId può comunque essere utilizzato per configurare la rete preferenziale.

PreferentialNetworkServiceConfig

Configurazione individuale del servizio di rete preferito.

Rappresentazione JSON 
{
  "preferentialNetworkId": enum (PreferentialNetworkId),
  "fallbackToDefaultConnection": enum (FallbackToDefaultConnection),
  "nonMatchingNetworks": enum (NonMatchingNetworks)
}
Campi
preferentialNetworkId

enum (PreferentialNetworkId)

Obbligatorio. Identificatore di rete preferenziale. Questo valore non deve essere impostato su NO_PREFERENTIAL_NETWORK o PREFERENTIAL_NETWORK_ID_UNSPECIFIED, altrimenti il criterio verrà rifiutato.
fallbackToDefaultConnection

enum (FallbackToDefaultConnection)

(Facoltativo) Indica se è consentito il fallback alla rete predefinita a livello di dispositivo. Se questo criterio è impostato su FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED, nonMatchingNetworks non deve essere impostato su NON_MATCHING_NETWORKS_DISALLOWED, altrimenti il criterio verrà rifiutato. Nota: se questa opzione è impostata su FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED, le applicazioni non possono accedere a internet se lo slice 5G non è disponibile.
nonMatchingNetworks

enum (NonMatchingNetworks)

(Facoltativo) Se le app a cui si applica questa configurazione non possono utilizzare reti diverse dal servizio preferenziale. Se questo valore è impostato su NON_MATCHING_NETWORKS_DISALLOWED, fallbackToDefaultConnection deve essere impostato su FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED.

FallbackToDefaultConnection

Indica se è consentito il fallback alla rete predefinita a livello di dispositivo. Tieni presente che, sebbene questa impostazione determini se le app soggette a questa configurazione dispongono di una rete predefinita in assenza di un servizio preferenziale, le app possono comunque decidere esplicitamente di utilizzare una rete diversa da quella predefinita richiedendola al sistema. Questa impostazione non determina se le app sono bloccate dall'utilizzo di altre reti. Per questa impostazione, vedi nonMatchingNetworks.

Enum
FALLBACK_TO_DEFAULT_CONNECTION_UNSPECIFIED Non specificato. Il valore predefinito è FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED.
FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED È consentito il fallback alla connessione predefinita. Se questo criterio è impostato, nonMatchingNetworks non deve essere impostato su NON_MATCHING_NETWORKS_DISALLOWED, altrimenti il criterio verrà rifiutato.
FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED Il fallback alla connessione predefinita non è consentito.

NonMatchingNetworks

Se le app a cui si applica questa configurazione possono utilizzare reti diverse dal servizio preferenziale. Le app possono esaminare l'elenco delle reti disponibili sul dispositivo e scegliere di utilizzare più reti contemporaneamente per motivi di prestazioni, privacy o altro.

Enum
NON_MATCHING_NETWORKS_UNSPECIFIED Non specificato. Il valore predefinito è NON_MATCHING_NETWORKS_ALLOWED.
NON_MATCHING_NETWORKS_ALLOWED Le app a cui si applica questa configurazione possono utilizzare reti diverse dal servizio preferenziale.
NON_MATCHING_NETWORKS_DISALLOWED Le app a cui si applica questa configurazione non possono utilizzare altre reti oltre al servizio preferenziale. Questa impostazione può essere configurata su Android 14 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 14. Se questo criterio è impostato, fallbackToDefaultConnection deve essere impostato su FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED, altrimenti il criterio verrà rifiutato.

ApnPolicy

Policy del nome punto di accesso (APN). Configurazione per i nomi punti di accesso (APN) che possono eseguire l'override di qualsiasi altro APN sul dispositivo. Per i dettagli, consulta OVERRIDE_APNS_ENABLED e overrideApns.

Rappresentazione JSON 
{
  "overrideApns": enum (OverrideApns),
  "apnSettings": [
    {
      object (ApnSetting)
    }
  ]
}
Campi
overrideApns

enum (OverrideApns)

(Facoltativo) Indica se gli APN di override sono disattivati o attivati. Per ulteriori dettagli, consulta DevicePolicyManager.setOverrideApnsEnabled.
apnSettings[]

object (ApnSetting)

(Facoltativo) Impostazioni APN per gli APN di override. Non deve esserci alcun conflitto tra le impostazioni APN fornite, altrimenti le norme verranno rifiutate. Due ApnSetting sono considerati in conflitto quando tutti i seguenti campi corrispondono in entrambi: numericOperatorId, apn, proxyAddress, proxyPort, mmsProxyAddress, mmsProxyPort, mmsc, mvnoType, protocol, roamingProtocol. Se alcune impostazioni APN comportano la mancata conformità a INVALID_VALUE , verranno ignorate. Questa impostazione può essere configurata sui dispositivi completamente gestiti con Android 10 e versioni successive. Questa impostazione può essere configurata anche sui profili di lavoro su Android 13 e versioni successive e solo con ApnSetting con tipo di APN ENTERPRISE. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 10. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro sulle versioni di Android precedenti alla 13.

OverrideApns

Indica se gli APN di override sono disattivati o attivati. Per ulteriori dettagli, consulta DevicePolicyManager.setOverrideApnsEnabled.

Enum
OVERRIDE_APNS_UNSPECIFIED Non specificato. Il valore predefinito è OVERRIDE_APNS_DISABLED.
OVERRIDE_APNS_DISABLED Override APN disattivati. Tutti i apnSettings configurati vengono salvati sul dispositivo, ma sono disattivati e non hanno alcun effetto. Tutti gli altri APN sul dispositivo rimangono in uso.
OVERRIDE_APNS_ENABLED Override degli APN attivati. Vengono utilizzati solo gli APN di override, tutti gli altri APN vengono ignorati. Questa impostazione può essere configurata solo sui dispositivi completamente gestiti con Android 10 e versioni successive. Per i profili di lavoro, gli APN di override sono abilitati tramite preferentialNetworkServiceSettings e questo valore non può essere impostato. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 10. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.

ApnSetting

Una configurazione del nome punto di accesso (APN) per una connessione dati dell'operatore. L'APN fornisce la configurazione per connettere un dispositivo di rete mobile a una rete dati IP. Un operatore utilizza questa impostazione per decidere quale indirizzo IP assegnare, quali metodi di sicurezza applicare e come il dispositivo può essere connesso alle reti private.

Rappresentazione JSON 
{
  "apnTypes": [
    enum (ApnType)
  ],
  "apn": string,
  "displayName": string,
  "alwaysOnSetting": enum (AlwaysOnSetting),
  "authType": enum (AuthType),
  "carrierId": integer,
  "mmsProxyAddress": string,
  "mmsProxyPort": integer,
  "mmsc": string,
  "mtuV4": integer,
  "mtuV6": integer,
  "mvnoType": enum (MvnoType),
  "networkTypes": [
    enum (NetworkType)
  ],
  "username": string,
  "password": string,
  "numericOperatorId": string,
  "protocol": enum (Protocol),
  "roamingProtocol": enum (Protocol),
  "proxyAddress": string,
  "proxyPort": integer
}
Campi
apnTypes[]

enum (ApnType)

Obbligatorio. Categorie di utilizzo per l'APN. La norma verrà rifiutata se questo campo è vuoto o contiene APN_TYPE_UNSPECIFIED o duplicati. Sui dispositivi completamente gestiti è possibile impostare più tipi di APN. ENTERPRISE è l'unico tipo di APN consentito nei profili di lavoro. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per qualsiasi altro valore nei profili di lavoro. I tipi di APN non supportati sul dispositivo o nella modalità di gestione verranno ignorati. Se il risultato è un elenco vuoto, l'impostazione APN verrà ignorata perché apnTypes è un campo obbligatorio. Viene segnalato un NonComplianceDetail con INVALID_VALUE se nessuno dei tipi di APN è supportato sul dispositivo o nella modalità di gestione.
apn

string

Obbligatorio. Nome dell'APN. La policy verrà rifiutata se questo campo è vuoto.
displayName

string

Obbligatorio. Nome leggibile che descrive l'APN. La policy verrà rifiutata se questo campo è vuoto.
alwaysOnSetting

enum (AlwaysOnSetting)

(Facoltativo) Indica se le risorse del piano utente devono essere attivate durante ogni transizione dalla modalità CM-IDLE allo stato CM-CONNECTED per questo APN. Consulta la sezione 5.6.13 di 3GPP TS 23.501.
authType

enum (AuthType)

(Facoltativo) Tipo di autenticazione dell'APN.
carrierId

integer

(Facoltativo) ID operatore per l'APN. Un valore pari a 0 (impostazione predefinita) indica che non è impostato e i valori negativi vengono rifiutati.
mmsProxyAddress

string

(Facoltativo) Indirizzo proxy MMS (Multimedia Messaging Service) dell'APN, che può essere un indirizzo IP o un nome host (non un URL).
mmsProxyPort

integer

(Facoltativo) Porta proxy MMS (Multimedia Messaging Service) dell'APN. Un valore pari a 0 (impostazione predefinita) indica che non è impostato e i valori negativi vengono rifiutati.
mmsc

string

(Facoltativo) URI MMSC (Multimedia Messaging Service Center) dell'APN.
mtuV4

integer

(Facoltativo) Le dimensioni predefinite in byte dell'unità massima di trasmissione (MTU) delle route IPv4 visualizzate da questa impostazione APN. Un valore pari a 0 (impostazione predefinita) indica che non è impostato e i valori negativi vengono rifiutati. Supportato su Android 13 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.
mtuV6

integer

(Facoltativo) La dimensione MTU (Maximum Transmission Unit) dell'interfaccia mobile IPv6 a cui è connesso l'APN. Un valore pari a 0 (impostazione predefinita) indica che non è impostato e i valori negativi vengono rifiutati. Supportato su Android 13 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.
mvnoType

enum (MvnoType)

(Facoltativo) Tipo di corrispondenza MVNO per l'APN.
networkTypes[]

enum (NetworkType)

(Facoltativo) Tecnologie radio (tipi di rete) che l'APN può utilizzare. La policy verrà rifiutata se questo campo contiene NETWORK_TYPE_UNSPECIFIED o duplicati.
username

string

(Facoltativo) Nome utente APN dell'APN.
password

string

(Facoltativo) Password APN dell'APN.
numericOperatorId

string

(Facoltativo) L'ID operatore numerico dell'APN. L'ID operatore numerico è definito come MCC (Mobile Country Code) + MNC (Mobile Network Code).
protocol

enum (Protocol)

(Facoltativo) Il protocollo da utilizzare per connettersi a questo APN.
roamingProtocol

enum (Protocol)

(Facoltativo) Il protocollo da utilizzare per connettersi a questo APN mentre il dispositivo è in roaming.
proxyAddress

string

(Facoltativo) L'indirizzo proxy dell'APN.
proxyPort

integer

(Facoltativo) La porta proxy dell'APN. Un valore pari a 0 (impostazione predefinita) indica che non è impostato e i valori negativi vengono rifiutati.

ApnType

Categoria di utilizzo per l'APN.

Enum
APN_TYPE_UNSPECIFIED Non specificato. Questo valore non viene utilizzato.
ENTERPRISE Tipo di APN per il traffico aziendale. Supportato su Android 13 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.
BIP Tipo di APN per BIP (Bearer Independent Protocol). Questa impostazione può essere configurata solo sui dispositivi completamente gestiti con Android 12 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 12. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
CBS Tipo di APN per CBS (Carrier Branded Services). Questa impostazione può essere configurata solo sui dispositivi completamente gestiti. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
DEFAULT Tipo di APN per il traffico di dati predefinito. Questa impostazione può essere configurata solo sui dispositivi completamente gestiti. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
DUN Tipo di APN per il traffico DUN (Dial-up networking). Questa impostazione può essere configurata solo sui dispositivi completamente gestiti. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
EMERGENCY Tipo di APN per la PDN di emergenza. Non si tratta di un APN IA, ma viene utilizzato per accedere ai servizi dell'operatore in caso di chiamata di emergenza. Questa impostazione può essere configurata solo sui dispositivi completamente gestiti. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
FOTA Tipo di APN per accedere al portale FOTA (Firmware Over-the-Air) dell'operatore, utilizzato per gli aggiornamenti over-the-air. Questa impostazione può essere configurata solo sui dispositivi completamente gestiti. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
HIPRI Tipo di APN per il traffico HiPri (priorità elevata). Questa impostazione può essere configurata solo sui dispositivi completamente gestiti. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
IA Tipo di APN per l'APN IA (Initial Attach). Questa impostazione può essere configurata solo sui dispositivi completamente gestiti. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
IMS Tipo di APN per il traffico IMS (IP Multimedia Subsystem). Questa impostazione può essere configurata solo sui dispositivi completamente gestiti. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
MCX Tipo di APN per MCX (Mission Critical Service) in cui X può essere PTT/Video/Data. Questa impostazione può essere configurata solo sui dispositivi completamente gestiti. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
MMS Tipo di APN per il traffico MMS (Multimedia Messaging Service). Questa impostazione può essere configurata solo sui dispositivi completamente gestiti. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
RCS Tipo di APN per RCS (Rich Communication Services). Questa impostazione può essere configurata solo sui dispositivi completamente gestiti con Android 15 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 15. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
SUPL Tipo di APN per il GPS assistito SUPL (Secure User Plane Location). Questa impostazione può essere configurata solo sui dispositivi completamente gestiti. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
VSIM Tipo di APN per il servizio VSIM (SIM virtuale). Questa impostazione può essere configurata solo sui dispositivi completamente gestiti con Android 12 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 12. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.
XCAP Tipo di APN per il traffico XCAP (XML Configuration Access Protocol). Questa impostazione può essere configurata solo sui dispositivi completamente gestiti con Android 11 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 11. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato per i profili di lavoro.

AlwaysOnSetting

Indica se le risorse del piano utente devono essere attivate durante ogni transizione dalla modalità CM-IDLE allo stato CM-CONNECTED per questo APN. Consulta la sezione 5.6.13 di 3GPP TS 23.501.

Enum
ALWAYS_ON_SETTING_UNSPECIFIED Non specificato. Il valore predefinito è NOT_ALWAYS_ON.
NOT_ALWAYS_ON La sessione PDU attivata da questo APN non deve essere sempre attiva.
ALWAYS_ON La sessione PDU attivata da questo APN deve essere sempre attiva. Supportato su Android 15 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 15.

AuthType

Tipo di autenticazione dell'APN.

Enum
AUTH_TYPE_UNSPECIFIED Non specificato. Se username è vuoto, il valore predefinito è NONE. In caso contrario, il valore predefinito è PAP_OR_CHAP.
NONE L'autenticazione non è richiesta.
PAP Tipo di autenticazione per PAP.
CHAP Tipo di autenticazione per CHAP.
PAP_OR_CHAP Tipo di autenticazione per PAP o CHAP.

MvnoType

Tipo di corrispondenza MVNO per l'APN.

Enum
MVNO_TYPE_UNSPECIFIED Il tipo di MVNO non è specificato.
GID Tipo di MVNO per l'identificatore di gruppo di livello 1.
ICCID Tipo di MVNO per l'ICCID.
IMSI Tipo MVNO per IMSI.
SPN Tipo MVNO per SPN (nome del service provider).

NetworkType

La tecnologia radio (tipo di rete) che l'APN può utilizzare.

Enum
NETWORK_TYPE_UNSPECIFIED Non specificato. Questo valore non deve essere utilizzato.
EDGE Tecnologia radio EDGE.
GPRS Tecnologia radio GPRS.
GSM Tecnologia radio GSM.
HSDPA Tecnologia radio HSDPA.
HSPA Tecnologia radio HSPA.
HSPAP Tecnologia radio HSPAP.
HSUPA Tecnologia radio HSUPA.
IWLAN Tecnologia radio IWLAN.
LTE Tecnologia radio LTE.
NR Tecnologia radio NR (New Radio) 5G.
TD_SCDMA Tecnologia radio TD_SCDMA.
UMTS Tecnologia radio UMTS.

Protocollo

Il protocollo da utilizzare per connettersi all'APN.

Enum
PROTOCOL_UNSPECIFIED Il protocollo non è specificato.
IP Protocollo internet.
IPV4V6 Tipo di PDP virtuale introdotto per gestire la funzionalità UE a doppio stack IP.
IPV6 Internet Protocol, versione 6.
NON_IP Trasferimento di dati non IP a una rete di dati a pacchetti esterna.
PPP Protocollo point-to-point.
UNSTRUCTURED Trasferimento di dati non strutturati alla rete dati tramite N6.

DeviceRadioState

Controlli per le impostazioni della 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 Ultra Wideband e se l'utente può attivarla o disattivarla.
cellularTwoGState

enum (CellularTwoGState)

Controlla se l'impostazione 2G cellulare può essere attivata o disattivata dall'utente.
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 disattivato come stato 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 può disattivarlo. Se la versione di Android è precedente alla 13, viene segnalato un NonComplianceDetail con API_LEVEL.
WIFI_DISABLED Il Wi-Fi è disattivato e l'utente non è autorizzato ad attivarlo. 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 su dispositivi completamente gestiti e profili di lavoro su dispositivi di proprietà dell'azienda.

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

UltraWidebandState

Controlla lo stato dell'impostazione Ultra Wideband e se l'utente può attivarla o disattivarla. Supportato su Android 14 e versioni successive. Supportato su dispositivi completamente gestiti e profili di lavoro su 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 l'ultra wideband.
ULTRA_WIDEBAND_DISABLED La banda ultralarga è disattivata. L'utente non è autorizzato ad attivare la banda ultralarga 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 su dispositivi completamente gestiti e profili di lavoro su dispositivi di proprietà dell'azienda.

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

MinimumWifiSecurityLevel

Definisce i diversi livelli minimi di sicurezza Wi-Fi richiesti per connettersi alle reti Wi-Fi. Supportato su Android 13 e versioni successive. Supportato su dispositivi completamente gestiti e profili di lavoro su 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 a reti Wi-Fi aperte. Questo criterio è più rigoroso 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ù rigoroso 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ù rigoroso di ENTERPRISE_NETWORK_SECURITY. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 13.

CredentialProviderPolicyDefault

Controlla quali app possono fungere da fornitori di credenziali su Android 14 e versioni successive. Queste app archiviano le credenziali. Per maggiori dettagli, consulta questo e questo. Vedi anche credentialProviderPolicy.

Enum
CREDENTIAL_PROVIDER_POLICY_DEFAULT_UNSPECIFIED Non specificato. Il valore predefinito è CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED.
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED Le app con credentialProviderPolicy non specificato non sono autorizzate a fungere da fornitore di credenziali.
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED_EXCEPT_SYSTEM Le app con credentialProviderPolicy non specificato non sono autorizzate a fungere da fornitore di credenziali, ad eccezione dei fornitori di credenziali predefiniti OEM. I provider di credenziali predefiniti OEM sono sempre autorizzati ad agire come provider 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. Se la versione di Android è precedente alla 9, viene segnalato un NonComplianceDetail con API_LEVEL.
PRINTING_ALLOWED La stampa è consentita.

DisplaySettings

Controlli per le impostazioni di visualizzazione.

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

object (ScreenBrightnessSettings)

(Facoltativo) Controlla le impostazioni di luminosità dello schermo.
screenTimeoutSettings

object (ScreenTimeoutSettings)

(Facoltativo) Controlla le impostazioni di spegnimento dello schermo.

ScreenBrightnessSettings

Controlli per le impostazioni di 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 non è impostata alcuna luminosità dello schermo. 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. Se la versione di Android è precedente alla 9, viene segnalato un NonComplianceDetail con API_LEVEL. Supportato sui profili di lavoro sui dispositivi di proprietà aziendale con 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 può configurare la luminosità dello schermo. screenBrightness non deve essere impostato.
BRIGHTNESS_AUTOMATIC La modalità di luminosità dello schermo è automatica, quindi la luminosità viene regolata automaticamente e l'utente non può 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. Se la versione di Android è precedente alla 9, viene segnalato un NonComplianceDetail con API_LEVEL. Supportato sui profili di lavoro sui dispositivi di proprietà aziendale con Android 15 e versioni successive.
BRIGHTNESS_FIXED La modalità di luminosità dello schermo è fissa, la luminosità è impostata su screenBrightness e l'utente non può configurarla. È necessario impostare screenBrightness. Supportato su Android 9 e versioni successive sui dispositivi completamente gestiti. Se la versione di Android è precedente alla 9, viene segnalato un NonComplianceDetail con API_LEVEL. Supportato sui profili di lavoro sui dispositivi di proprietà aziendale con 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 lo spegnimento 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 limite. Il limite inferiore può variare a seconda dei dispositivi. Se questo valore è impostato, screenTimeoutMode deve essere SCREEN_TIMEOUT_ENFORCED. Supportato su Android 9 e versioni successive sui dispositivi completamente gestiti. Se la versione di Android è precedente alla 9, viene segnalato un NonComplianceDetail con API_LEVEL. Supportato sui profili di lavoro sui dispositivi di proprietà aziendale con 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 lo spegnimento dello schermo.

Enum
SCREEN_TIMEOUT_MODE_UNSPECIFIED Non specificato. Il valore predefinito è SCREEN_TIMEOUT_USER_CHOICE.
SCREEN_TIMEOUT_USER_CHOICE L'utente può configurare il timeout dello schermo. screenTimeout non deve essere impostato.
SCREEN_TIMEOUT_ENFORCED Il timeout dello schermo è impostato su screenTimeout e l'utente non può configurarlo. È necessario impostare screenTimeout. Supportato su Android 9 e versioni successive sui dispositivi completamente gestiti. Se la versione di Android è precedente alla 9, viene segnalato un NonComplianceDetail con API_LEVEL. Supportato sui profili di lavoro sui dispositivi di proprietà aziendale con Android 15 e versioni successive.

AssistContentPolicy

Controlla se è consentito inviare AssistContent a un'app con privilegi, 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

I contenuti di Assist sono bloccati e non possono essere inviati a un'app con privilegi.

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

I contenuti di Assistente possono essere inviati a un'app con privilegi.

Supportato su Android 15 e versioni successive.

WorkAccountSetupConfig

Controlla la configurazione dell'account di lavoro, ad esempio i dettagli relativi alla necessità di un account autenticato da Google.

Rappresentazione JSON 
{
  "authenticationType": enum (AuthenticationType),
  "requiredAccountEmail": string
}
Campi
authenticationType

enum (AuthenticationType)

(Facoltativo) Il tipo di autenticazione dell'utente sul dispositivo.
requiredAccountEmail

string

(Facoltativo) L'indirizzo email specifico dell'account Google Workspace da aggiungere. Questo campo è pertinente solo se authenticationType è GOOGLE_AUTHENTICATED. Deve essere un account aziendale e non un account consumer. Una volta impostato e aggiunto un account autenticato da Google al dispositivo, la modifica di questo campo non avrà effetto, pertanto è consigliabile impostarlo una sola volta.

AuthenticationType

Il tipo di autenticazione dell'utente sul dispositivo.

Enum
AUTHENTICATION_TYPE_UNSPECIFIED Non specificato. Il valore predefinito è AUTHENTICATION_TYPE_NOT_ENFORCED.
AUTHENTICATION_TYPE_NOT_ENFORCED Lo stato di autenticazione dell'utente sul dispositivo non viene applicato.
GOOGLE_AUTHENTICATED Richiede che il dispositivo sia gestito con un account autenticato da Google.

WipeDataFlag

I flag di cancellazione per indicare quali dati vengono cancellati quando viene attivata la cancellazione di un dispositivo o di un profilo per qualsiasi motivo. Ad esempio, quando il dispositivo non è conforme. Ciò non si applica al metodo enterprises.devices.delete.

Enum
WIPE_DATA_FLAG_UNSPECIFIED Questo valore non deve essere utilizzato.
WIPE_ESIMS Per i dispositivi di proprietà aziendale, l'impostazione in wipeDataFlags rimuoverà tutte le eSIM sul dispositivo quando viene attivata la cancellazione per qualsiasi motivo. Sui dispositivi di proprietà personale, verranno rimosse solo le eSIM gestite sul dispositivo. (eSIM aggiunte tramite il comando ADD_ESIM). Questa funzionalità è supportata sui dispositivi con Android 15 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 15.

EnterpriseDisplayNameVisibility

Controlla se il enterpriseDisplayName è visibile sul dispositivo (ad es. il messaggio della schermata di blocco sui dispositivi di proprietà dell'azienda).

Enum
ENTERPRISE_DISPLAY_NAME_VISIBILITY_UNSPECIFIED Non specificato. Per impostazione predefinita, viene visualizzato il nome dell'azienda impostato al momento della configurazione del dispositivo. In futuro, questa impostazione sarà predefinita su ENTERPRISE_DISPLAY_NAME_VISIBLE.
ENTERPRISE_DISPLAY_NAME_VISIBLE Il nome visualizzato dell'azienda è visibile sul dispositivo. Supportato sui profili di lavoro su Android 7 e versioni successive. Funzionalità supportata sui dispositivi completamente gestiti con Android 8 e versioni successive. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è inferiore alla 7. Un NonComplianceDetail con MANAGEMENT_MODE viene segnalato sui dispositivi completamente gestiti con Android 7.
ENTERPRISE_DISPLAY_NAME_HIDDEN Il nome visualizzato dell'azienda è nascosto sul dispositivo.

AppFunctions

Controlla se le app sul dispositivo per i dispositivi completamente gestiti o nel profilo di lavoro per i dispositivi con profili di lavoro possono esporre le funzioni delle app.

Enum
APP_FUNCTIONS_UNSPECIFIED Non specificato. Il valore predefinito è APP_FUNCTIONS_ALLOWED.
APP_FUNCTIONS_DISALLOWED Le app sul dispositivo per i dispositivi completamente gestiti o nel profilo di lavoro per i dispositivi con profili di lavoro non possono esporre le funzioni delle app. Se questo criterio è impostato, crossProfileAppFunctions non deve essere impostato su CROSS_PROFILE_APP_FUNCTIONS_ALLOWED, altrimenti il criterio verrà rifiutato.
APP_FUNCTIONS_ALLOWED Le app sul dispositivo per i dispositivi completamente gestiti o nel profilo di lavoro per i dispositivi con profili di lavoro possono esporre le funzioni delle app.

Metodi

delete

 Elimina una norma.

get

 Recupera un criterio.

list

 Elenca le norme per una determinata azienda.

modifyPolicyApplications

 Aggiorna o crea applicazioni in un criterio.

patch

 Aggiorna o crea un criterio.

removePolicyApplications

 Rimuove le applicazioni in una policy.