MCP Tools Reference: Android Device Management MCP Server

Strumento: list_policies

Elenca le norme per una determinata azienda. Richiede il nome della risorsa aziendale nel campo padre (ad es. enterprises/{enterpriseId}).

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP list_policies.

Curl Request
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_policies",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

Schema di input

Richiesta di elencare le norme per una determinata azienda.

ListPoliciesRequest

Rappresentazione JSON
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Campi
parent

string

Il nome dell'impresa nel modulo enterprises/{enterpriseId}.

pageSize

integer

Le dimensioni della pagina richiesta. Le dimensioni effettive della pagina potrebbero essere fisse a un valore minimo o massimo.

pageToken

string

Un token che identifica una pagina di risultati restituita dal server.

Schema di output

Risposta a una richiesta di elencare le norme per una determinata azienda.

ListPoliciesResponse

Rappresentazione JSON
{
  "policies": [
    {
      object (Policy)
    }
  ],
  "nextPageToken": string
}
Campi
policies[]

object (Policy)

L'elenco delle policy.

nextPageToken

string

Se sono presenti altri risultati, un token per recuperare la pagina successiva dei risultati.

Norme

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),
  "defaultApplicationSettings": [
    {
      object (DefaultApplicationSetting)
    }
  ]
}
Campi
name

string

Il nome della policy nel formato enterprises/{enterpriseId}/policies/{policyId}.

version

string (int64 format)

La versione della policy. Questo è un campo di sola lettura. La versione viene incrementata ogni volta che le norme vengono aggiornate.

applications[]

object (ApplicationPolicy)

Policy 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 esiste alcuna limitazione.

screenCaptureDisabled

boolean

Indica se l'acquisizione schermo è disattivata.

cameraDisabled
(deprecated)

boolean

Se camera_access è 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

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 possono essere 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 le password. Il campo password_requirements.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. unified_lock_settings non può essere utilizzato qui.

wifiConfigsLockdownEnabled
(deprecated)

boolean

Questa opzione è deprecata.

bluetoothConfigDisabled

boolean

Indica se la configurazione del Bluetooth è disattivata.

cellBroadcastsConfigDisabled

boolean

Indica se la configurazione di cell broadcast è disattivata.

credentialsConfigDisabled

boolean

Indica se la configurazione delle credenziali utente è disattivata.

mobileNetworksConfigDisabled

boolean

Indica se la configurazione delle reti mobile è 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 è disattivato.

outgoingCallsDisabled

boolean

Se le chiamate in uscita sono disattivate.

removeUserDisabled

boolean

Indica se la rimozione di altri utenti è disattivata.

shareLocationDisabled

boolean

Se la condivisione della posizione è disattivata.

smsDisabled

boolean

Se l'invio e la ricezione di SMS sono disabilitati.

unmuteMicrophoneDisabled
(deprecated)

boolean

Se microphone_access è 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 opzione è disponibile solo sui dispositivi completamente gestiti.

usbFileTransferDisabled
(deprecated)

boolean

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

ensureVerifyAppsEnabled
(deprecated)

boolean

Indica se la verifica dell'app è abilitata 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 maximum_time_to_lock 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 open_network_configuration. 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. Questo vale solo per i dispositivi con Android 7 e versioni successive.

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 vpn_config_disabled 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 l'escape hatch 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 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 bluetooth_config_disabled perché bluetooth_config_disabled 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 vengono soddisfatte le condizioni di più regole, vengono intraprese tutte le azioni di mitigazione per le regole. Il limite massimo è di 100 regole. Utilizza invece le regole di applicazione dei criteri.

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 alcun 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 di aggiornamento.

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

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

kioskCustomLauncherEnabled

boolean

Indica se il launcher personalizzato del chiosco è abilitato. In questo modo, la schermata Home viene sostituita da un launcher che blocca il dispositivo sulle 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 per tutte le app. Questi valori sostituiscono default_permission_policy.

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)

Azione da intraprendere 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 password_scope 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 preferenziale supportato è lo slice 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 del logging 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. Questa impostazione si applica solo ai 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.

defaultApplicationSettings[]

object (DefaultApplicationSetting)

Facoltativo. L'impostazione predefinita dell'applicazione per i tipi supportati. Se l'applicazione predefinita viene impostata correttamente per almeno un tipo di app in un profilo, gli utenti non possono modificare nessuna applicazione predefinita in quel profilo.

È consentito un solo DefaultApplicationSetting per ogni DefaultApplicationType.

Per maggiori dettagli, consulta la guida Impostazioni predefinite dell'applicazione.

ApplicationPolicy

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),
  "customAppConfig": {
    object (CustomAppConfig)
  },
  "installConstraint": [
    {
      object (InstallConstraint)
    }
  ],
  "installPriority": integer,
  "userControlSettings": enum (UserControlSettings),
  "preferentialNetworkId": enum (PreferentialNetworkId),
  "signingKeyCerts": [
    {
      object (ApplicationSigningKeyCert)
    }
  ],
  "roles": [
    {
      object (Role)
    }
  ]
}
Campi
packageName

string

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

installType

enum (InstallType)

Il tipo di installazione da eseguire.

lockTaskAllowed
(deprecated)

boolean

Indica se l'app può bloccarsi in modalità a schermo intero. OBSOLETO. 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 default_permission_policy a livello di criterio, che si applica a tutte le app. Non sostituisce le permission_grants, che si applicano a tutte le app.

permissionGrants[]

object (PermissionGrant)

Concessioni o negazioni esplicite di autorizzazioni per l'app. Questi valori sostituiscono default_permission_policy e permission_grants, 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 l'type di ManagedProperty:

typeValore JSON
BOOLtrue o false
STRINGstringa
INTEGERnumero
CHOICEstringa
MULTISELECTarray di stringhe
HIDDENstringa
BUNDLE_ARRAYarray di oggetti
Nota: i valori stringa non possono contenere più di 65.535 caratteri.

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 non_compliance_reason 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 managed_configuration.

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. Ulteriori 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
(deprecated)

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. Se è presente un'app con il ruolo COMPANION_APP, questo campo non può essere impostato.

L'impronta del certificato della chiave di firma dell'app sul dispositivo deve corrispondere a una delle voci in ApplicationPolicy.signingKeyCerts o ExtensionConfig.signingKeyFingerprintsSha256 (ritirato) oppure alle impronte del certificato della chiave di firma ottenute dal Play Store affinché l'app possa comunicare con Android Device Policy. Se l'app non è sul Play Store e se ApplicationPolicy.signingKeyCerts e ExtensionConfig.signingKeyFingerprintsSha256 (ritirati) non sono impostati, 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 non_compliance_reason impostato su API_LEVEL e un fieldPath. Se non è applicabile all'app, il dispositivo conterrà un NonComplianceDetail con non_compliance_reason 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 può fungere da fornitore di credenziali su Android 14 e versioni successive.

customAppConfig

object (CustomAppConfig)

Facoltativo. Configurazione per questa app personalizzata.

install_type deve essere impostato su CUSTOM.

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:

  • FORCE_INSTALLED
  • PREINSTALLED

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.

signingKeyCerts[]

object (ApplicationSigningKeyCert)

Facoltativo. Certificati della chiave di firma dell'app.

Questo campo è obbligatorio nei seguenti casi:

  • L'app ha installType impostato su CUSTOM (ovvero un'app personalizzata).
  • L'app ha roles impostato su un elenco non vuoto e l'app non esiste sul Play Store.
  • L'app ha impostato extensionConfig (ovvero un'app di estensione), ma ExtensionConfig.signingKeyFingerprintsSha256 (obsoleto) non è impostato e l'app non esiste sul Play Store.

Se questo campo non è impostato per un'app personalizzata, il criterio viene rifiutato. Se non è impostato quando è richiesto per un'app non personalizzata, viene segnalato un NonComplianceDetail con INVALID_VALUE.

Per gli altri casi, questo campo è facoltativo e vengono utilizzati i certificati della chiave di firma ottenuti dal Play Store.

Consulta le seguenti impostazioni dei criteri per scoprire come viene utilizzato questo campo:

  • choosePrivateKeyRules
  • ApplicationPolicy.InstallType.CUSTOM
  • ApplicationPolicy.extensionConfig
  • ApplicationPolicy.roles
roles[]

object (Role)

Facoltativo. Ruoli dell'app.

Le app con determinati ruoli possono essere esentate dalle limitazioni di esecuzione in background e di consumo energetico, dalla sospensione e dall'ibernazione su Android 14 e versioni successive. Il controllo utente può anche essere disattivato per le app con determinati ruoli su Android 11 e versioni successive. Per ulteriori dettagli, consulta la documentazione di ogni RoleType.

L'app riceve una notifica dei ruoli impostati se dispone di un servizio di ricezione delle notifiche con <meta-data android:name="com.google.android.managementapi.notification.NotificationReceiverService.SERVICE_APP_ROLES" android:value="" />. L'app riceve una notifica ogni volta che i suoi ruoli vengono aggiornati o dopo l'installazione quando ha un elenco di ruoli non vuoto. L'app può utilizzare questa notifica per avviarsi dopo l'installazione. Per ulteriori dettagli sui requisiti del servizio, consulta le guide Integrare l'SDK AMAPI e Gestire i ruoli dell'app.

Affinché le esenzioni vengano applicate e l'app riceva una notifica relativa ai ruoli, l'impronta del certificato della chiave di firma dell'app sul dispositivo deve corrispondere a una delle impronte del certificato della chiave di firma ottenute dal Play Store o a una delle voci in ApplicationPolicy.signingKeyCerts. In caso contrario, viene segnalato un NonComplianceDetail con APP_SIGNING_CERT_MISMATCH.

Non devono essere presenti ruoli duplicati con lo stesso roleType. Più app non possono avere un ruolo con lo stesso roleType. Un ruolo di tipo ROLE_TYPE_UNSPECIFIED non è consentito.

PermissionGrant

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.

Struct

Rappresentazione JSON
{
  "fields": {
    string: value,
    ...
  }
}
Campi
fields

map (key: string, value: value (Value format))

Mappa non ordinata di valori digitati dinamicamente.

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

FieldsEntry

Rappresentazione JSON
{
  "key": string,
  "value": value
}
Campi
key

string

value

value (Value format)

Valore

Rappresentazione JSON
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
Campi
Campo unione kind. Il tipo di valore. kind può essere solo uno dei seguenti tipi:
nullValue

null

Rappresenta un valore null.

numberValue

number

Rappresenta un valore doppio.

stringValue

string

Rappresenta un valore stringa.

boolValue

boolean

Rappresenta un valore booleano.

structValue

object (Struct format)

Rappresenta un valore strutturato.

listValue

array (ListValue format)

Rappresenta un Value ripetuto.

ListValue

Rappresentazione JSON
{
  "values": [
    value
  ]
}
Campi
values[]

value (Value format)

Campo ripetuto di valori con tipo dinamico.

ManagedConfigurationTemplate

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" }.

ConfigurationVariablesEntry

Rappresentazione JSON
{
  "key": string,
  "value": string
}
Campi
key

string

value

string

ExtensionConfig

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

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.

I fingerprint del certificato della chiave di firma vengono sempre ottenuti dal Play Store e questo campo viene utilizzato per fornire fingerprint del certificato della chiave di firma aggiuntivi. 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
(deprecated)

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 Integrazione con l'SDK AMAPI).

CustomAppConfig

Rappresentazione JSON
{
  "userUninstallSettings": enum (UserUninstallSettings)
}
Campi
userUninstallSettings

enum (UserUninstallSettings)

Facoltativo. Impostazioni di disinstallazione dell'utente dell'app personalizzata.

InstallConstraint

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.

ApplicationSigningKeyCert

Rappresentazione JSON
{
  "signingKeyCertFingerprintSha256": string
}
Campi
signingKeyCertFingerprintSha256

string (bytes format)

Obbligatorio. Il valore hash SHA-256 del certificato della chiave di firma dell'app. Deve essere un valore hash SHA-256 valido, ovvero 32 byte. In caso contrario, il criterio viene rifiutato.

Una stringa con codifica in base64.

Ruolo

Rappresentazione JSON
{
  "roleType": enum (RoleType)
}
Campi
roleType

enum (RoleType)

Obbligatorio. Il tipo di ruolo che un'app può avere.

PersistentPreferredActivity

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

Rappresentazione JSON
{
  "type": enum (SystemUpdateType),
  "startMinutes": integer,
  "endMinutes": integer,
  "allowedDaysWithoutUpdate": 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 start_minutes, 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.

allowedDaysWithoutUpdate

integer

Se questo valore è maggiore di zero, indica il numero di giorni dopo la disponibilità di un aggiornamento in attesa durante i quali un dispositivo può rimanere conforme senza eseguire l'aggiornamento. Altrimenti non ha alcun effetto.

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.

FreezePeriod

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 la fine e l'inizio dell'anno. Nota: è necessario impostare day e month. year non deve essere impostato perché non viene utilizzato. Ad esempio: {"month": 1,"date": 30}.

Data

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

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,
  "defaultApplicationInfoReportingEnabled": boolean
}
Campi
applicationReportsEnabled

boolean

Indica se i report delle 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 application_reports_enabled è true.

commonCriteriaModeEnabled

boolean

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

defaultApplicationInfoReportingEnabled

boolean

Facoltativo. Indica se il reporting di defaultApplicationInfo è attivato.

ApplicationReportingSettings

Rappresentazione JSON
{
  "includeRemovedApps": boolean
}
Campi
includeRemovedApps

boolean

Se le app rimosse sono incluse nei report sulle applicazioni.

UserFacingMessage

Rappresentazione JSON
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Campi
localizedMessages

map (key: string, value: string)

Una mappa contenente coppie <locale, messaggio>, dove locale è un codice di lingua BCP 47 ben formato, ad esempio en-US, es-ES o fr.

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

defaultMessage

string

Il messaggio predefinito visualizzato se non viene specificato alcun messaggio localizzato o se le impostazioni internazionali dell'utente non corrispondono a nessuno dei messaggi localizzati. Se vengono forniti messaggi localizzati, è necessario fornire un messaggio predefinito.

LocalizedMessagesEntry

Rappresentazione JSON
{
  "key": string,
  "value": string
}
Campi
key

string

value

string

PasswordRequirements

Rappresentazione JSON
{
  "passwordMinimumLength": integer,
  "passwordMinimumLetters": integer,
  "passwordMinimumLowerCase": integer,
  "passwordMinimumNonLetter": integer,
  "passwordMinimumNumeric": integer,
  "passwordMinimumSymbols": integer,
  "passwordMinimumUpperCase": integer,
  "passwordQuality": enum (PasswordQuality),
  "passwordHistoryLength": integer,
  "maximumFailedPasswordsForWipe": integer,
  "passwordExpirationTimeout": string,
  "passwordScope": enum (PasswordPolicyScope),
  "requirePasswordUnlock": enum (RequirePasswordUnlock),
  "unifiedLockSettings": enum (UnifiedLockSettings)
}
Campi
passwordMinimumLength

integer

La lunghezza minima consentita della password. Un valore pari a 0 indica che non esiste alcuna limitazione. Applicato solo quando password_quality è NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC o COMPLEX.

passwordMinimumLetters

integer

Numero minimo di lettere richieste nella password. Applicato solo quando password_quality è COMPLEX.

passwordMinimumLowerCase

integer

Numero minimo di lettere minuscole richieste nella password. Applicato solo quando password_quality è COMPLEX.

passwordMinimumNonLetter

integer

Numero minimo di caratteri che non siano lettere (cifre numeriche o simboli) richiesti nella password. Applicato solo quando password_quality è COMPLEX.

passwordMinimumNumeric

integer

Numero minimo di cifre numeriche richieste nella password. Applicato solo quando password_quality è COMPLEX.

passwordMinimumSymbols

integer

Numero minimo di simboli richiesti nella password. Applicato solo quando password_quality è COMPLEX.

passwordMinimumUpperCase

integer

Numero minimo di lettere maiuscole richieste nella password. Applicato solo quando password_quality è COMPLEX.

passwordQuality

enum (PasswordQuality)

La qualità della password richiesta.

passwordHistoryLength

integer

La lunghezza della cronologia delle password. Dopo aver impostato questo campo, l'utente non potrà inserire una nuova password uguale a una delle password nella cronologia. Un valore pari a 0 indica che non esiste alcuna limitazione.

maximumFailedPasswordsForWipe

integer

Numero di password di sblocco del dispositivo errate che possono essere inserite prima della cancellazione dei dati del dispositivo. Un valore pari a 0 indica che non esiste alcuna limitazione.

passwordExpirationTimeout

string (Duration format)

Timeout scadenza password.

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

passwordScope

enum (PasswordPolicyScope)

L'ambito a cui si applica il requisito della password.

requirePasswordUnlock

enum (RequirePasswordUnlock)

Il periodo di tempo dopo che un dispositivo o un profilo di lavoro viene sbloccato utilizzando una forma di autenticazione avanzata (password, PIN, sequenza) durante il quale può essere sbloccato utilizzando qualsiasi altro metodo di autenticazione (ad es. impronta, agenti attendibili, volto). Trascorso il periodo di tempo specificato, per sbloccare il dispositivo o il profilo di lavoro possono essere utilizzate solo forme di autenticazione avanzata.

unifiedLockSettings

enum (UnifiedLockSettings)

Controlla se è consentito un blocco unificato per il dispositivo e il profilo di lavoro sui dispositivi con Android 9 e versioni successive con un profilo di lavoro. Può essere impostato solo se password_scope è impostato su SCOPE_PROFILE, altrimenti il criterio verrà rifiutato. Se l'utente non ha impostato un blocco separato per le app di lavoro e questo campo è impostato su REQUIRE_SEPARATE_WORK_LOCK, viene segnalato un NonComplianceDetail con nonComplianceReason impostato su USER_ACTION.

Durata

Rappresentazione JSON
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Secondi firmati dell'intervallo di tempo. Deve essere compreso tra -315.576.000.000 e +315.576.000.000 inclusi. Nota: questi limiti vengono calcolati in base a: 60 sec/min * 60 min/ora * 24 ore/giorno * 365,25 giorni/anno * 10.000 anni

nanos

integer

Frazioni di secondo con segno con risoluzione in nanosecondi dell'intervallo di tempo. Le durate inferiori a un secondo sono rappresentate con un campo seconds pari a 0 e un campo nanos positivo o negativo. Per durate di un secondo o più, un valore diverso da zero per il campo nanos deve avere lo stesso segno del campo seconds. Deve essere compreso tra -999.999.999 e +999.999.999 inclusi.

PackageNameList

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

string

Un elenco di nomi di pacchetto.

ProxyInfo

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

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. La fingerprint del certificato della chiave di firma dell'app viene verificata rispetto alle fingerprint del certificato della chiave di firma fornite da Play Store e ApplicationPolicy.signingKeyCerts . 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

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.

ComplianceRule

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 sul dispositivo è in esecuzione 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 tipi:
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

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

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.

SetupAction

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 tipi:
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 corrispondente installType nel criterio dell'applicazione deve essere impostato su REQUIRED_FOR_SETUP, altrimenti la configurazione non andrà a buon fine.

LaunchAppAction

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.

launch può essere solo uno dei seguenti tipi:

packageName

string

Nome del pacchetto dell'app da avviare

PolicyEnforcementRule

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 tipi:
settingName

string

La policy di primo livello da applicare. Ad esempio, applications o passwordPolicies.

BlockAction

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

integer

Numero di giorni di mancata conformità alle norme prima del blocco del dispositivo o del profilo di lavoro. Per bloccare immediatamente l'accesso, imposta il valore su 0. blockAfterDays deve essere inferiore a wipeAfterDays.

blockScope

enum (BlockScope)

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

WipeAction

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

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 vengono 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.

AdvancedSecurityOverrides

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 install_unknown_sources_allowed (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 (obsoleto) e debuggingFeaturesAllowed (obsoleto). Sui dispositivi di proprietà personale con un profilo di lavoro, l'impostazione di questa norma non disattiva l'avvio sicuro. In questo caso, viene segnalato un NonComplianceDetail con MANAGEMENT_MODE.

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, consulta 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 andare perse e potrebbe essere necessario riconfigurare le reti Wi-Fi configurate dall'azienda che richiedono l'intervento dell'utente.

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. Su Android 15 e versioni successive, viene segnalato un NonComplianceDetail con PENDING se la modifica del criterio è in attesa del riavvio del 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.

PersonalUsagePolicies

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 è vero, 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.

PersonalApplicationPolicy

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.

OncCertificateProvider

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 tipi:

contentProviderEndpoint

object (ContentProviderEndpoint)

Questa funzionalità non è disponibile a livello generale.

ContentProviderEndpoint

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

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 exemptions_to_show_work_contacts_in_personal_profile.

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 dei 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 work_profile_widgets 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:

  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED. In questo caso, queste esenzioni fungono da lista bloccata.
  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED. In questo caso, queste esenzioni fungono da lista consentita.
  • SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM. In questo caso, queste esenzioni fungono da lista consentita, oltre alle app di sistema già incluse nella lista consentita.

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

UsageLog

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

enum (LogType)

Specifica i tipi di log abilitati. Tieni presente che gli utenti riceveranno messaggi sul dispositivo quando la registrazione dell'utilizzo è 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.

DeviceConnectivityManagement

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 completamente 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 operazione 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 preferenziale del servizio di rete. 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.

WifiSsidPolicy

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 nelle norme. Questo campo non può 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.

WifiSsid

Rappresentazione JSON
{
  "wifiSsid": string
}
Campi
wifiSsid

string

Obbligatorio. SSID Wi-Fi rappresentato come stringa.

WifiRoamingPolicy

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

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.

PreferentialNetworkServiceSettings

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

object (PreferentialNetworkServiceConfig)

Obbligatorio. Configurazioni preferenziali dei servizi di rete che consentono di avere più slice 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 possono 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

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.

ApnPolicy

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

enum (OverrideApns)

Facoltativo. Indica se gli APN di override sono disattivati o attivati. Per maggiori 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 la norma verrà rifiutata. 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.

ApnSetting

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. La dimensione predefinita 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.

DeviceRadioState

Rappresentazione JSON
{
  "wifiState": enum (WifiState),
  "airplaneModeState": enum (AirplaneModeState),
  "ultraWidebandState": enum (UltraWidebandState),
  "cellularTwoGState": enum (CellularTwoGState),
  "minimumWifiSecurityLevel": enum (MinimumWifiSecurityLevel),
  "userInitiatedAddEsimSettings": enum (UserInitiatedAddEsimSettings)
}
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 minimo di sicurezza richiesto delle reti Wi-Fi a cui il dispositivo può connettersi.

userInitiatedAddEsimSettings

enum (UserInitiatedAddEsimSettings)

Facoltativo. Controlla se l'utente è autorizzato ad aggiungere profili eSIM.

DisplaySettings

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

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. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 9. Supportato sui profili di lavoro sui dispositivi di proprietà aziendale con Android 15 e versioni successive.

ScreenTimeoutSettings

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. Viene segnalato un NonComplianceDetail con API_LEVEL se la versione di Android è precedente alla 9. 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".

WorkAccountSetupConfig

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.

DefaultApplicationSetting

Rappresentazione JSON
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "defaultApplications": [
    {
      object (DefaultApplication)
    }
  ],
  "defaultApplicationScopes": [
    enum (DefaultApplicationScope)
  ]
}
Campi
defaultApplicationType

enum (DefaultApplicationType)

Obbligatorio. Il tipo di app per impostare l'applicazione predefinita.

defaultApplications[]

object (DefaultApplication)

Obbligatorio. L'elenco delle applicazioni che possono essere impostate come app predefinita per un determinato tipo. Questo elenco non deve essere vuoto o contenere duplicati. La prima app nell'elenco installata e qualificata per defaultApplicationType (ad es. l'app SMS per DEFAULT_SMS) viene impostata come app predefinita. Anche l'impronta del certificato della chiave di firma dell'app sul dispositivo deve corrispondere a una delle impronte del certificato della chiave di firma ottenute dal Play Store o a una delle voci in ApplicationPolicy.signingKeyCerts per poter essere impostata come predefinita.

Se defaultApplicationScopes contiene SCOPE_FULLY_MANAGED o SCOPE_WORK_PROFILE, l'app deve avere una voce in applications con installType impostato su un valore diverso da BLOCKED.

Viene segnalato un NonComplianceDetail con il motivo APP_NOT_INSTALLED e il motivo specifico DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE se nessuna delle app nell'elenco è installata. Viene segnalato un NonComplianceDetail con il motivo INVALID_VALUE e il motivo specifico DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE se è installata almeno un'app, ma l'applicazione della norma non va a buon fine per altri motivi (ad es. l'app non è del tipo giusto).

Quando si applica a SCOPE_PERSONAL_PROFILE su un dispositivo di proprietà aziendale con un profilo di lavoro, solo le app di sistema preinstallate possono essere impostate come predefinite. Viene segnalato un NonComplianceDetail con il motivo INVALID_VALUE e il motivo specifico DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE se le norme non vengono applicate al profilo personale.

defaultApplicationScopes[]

enum (DefaultApplicationScope)

Obbligatorio. Gli ambiti a cui deve essere applicata la policy. Questo elenco non deve essere vuoto o contenere duplicati.

Viene segnalato un NonComplianceDetail con il motivo MANAGEMENT_MODE e il motivo specifico DEFAULT_APPLICATION_SETTING_UNSUPPORTED_SCOPES se nessuno degli ambiti specificati può essere applicato alla modalità di gestione (ad esempio, un dispositivo completamente gestito riceve un criterio con solo SCOPE_PERSONAL_PROFILE nell'elenco).

DefaultApplication

Rappresentazione JSON
{
  "packageName": string
}
Campi
packageName

string

Obbligatorio. Il nome del pacchetto da impostare come applicazione predefinita. La policy viene rifiutata se il nome del pacchetto non è valido.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌