Strumento: get_policy
Recupera una norma per una determinata impresa e un determinato ID norma. Richiede il nome della risorsa nel formato: enterprises/{enterpriseId}/policies/{policyId}.
Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP get_policy.
| 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": "get_policy", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Schema di input
Richiesta di ottenere una norma.
GetPolicyRequest
| Rappresentazione JSON |
|---|
{ "name": string } |
| Campi | |
|---|---|
name |
Il nome della policy nel formato |
Schema di output
Una risorsa di criteri rappresenta un gruppo di impostazioni che regolano il comportamento di un dispositivo gestito e delle app installate su di esso.
Norme
| Rappresentazione JSON |
|---|
{ "name": string, "version": string, "applications": [ { object ( |
| Campi | |
|---|---|
name |
Il nome della policy nel formato |
version |
La versione della policy. Questo è un campo di sola lettura. La versione viene incrementata ogni volta che le norme vengono aggiornate. |
applications[] |
Policy applicata alle app. Può contenere al massimo 3000 elementi. |
maximumTimeToLock |
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 |
Indica se l'acquisizione schermo è disattivata. |
cameraDisabled |
Se |
keyguardDisabledFeatures[] |
Disattivare personalizzazioni del blocco tastiera, come i widget. |
defaultPermissionPolicy |
I criteri di autorizzazione predefiniti per le richieste di autorizzazione di runtime. |
persistentPreferredActivities[] |
Attività del gestore di intent predefinito. |
openNetworkConfiguration |
Configurazione di rete per il dispositivo. Per ulteriori informazioni, consulta Configurare le reti. |
systemUpdate |
Il criterio di aggiornamento del sistema, che controlla la modalità di applicazione degli aggiornamenti del sistema operativo. Se il tipo di aggiornamento è 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[] |
Tipi di account che non possono essere gestiti dall'utente. |
addUserDisabled |
Indica se l'aggiunta di nuovi utenti e profili è disattivata. Per i dispositivi in cui |
adjustVolumeDisabled |
Indica se la regolazione del volume principale è disattivata. Disattiva anche l'audio del dispositivo. L'impostazione ha effetto solo sui dispositivi completamente gestiti. |
factoryResetDisabled |
Se il ripristino dei dati di fabbrica dalle impostazioni è disattivato. |
installAppsDisabled |
Indica se l'installazione di app da parte dell'utente è disattivata. |
mountPhysicalMediaDisabled |
Indica se il montaggio di supporti esterni fisici da parte dell'utente è disattivato. |
modifyAccountsDisabled |
Se l'aggiunta o la rimozione di account è disattivata. |
safeBootDisabled |
Indica se il riavvio del dispositivo in modalità provvisoria è disattivato. |
uninstallAppsDisabled |
Indica se la disinstallazione delle applicazioni da parte dell'utente è disattivata. In questo modo, le app non possono essere disinstallate, nemmeno quelle rimosse utilizzando |
statusBarDisabled |
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 |
keyguardDisabled |
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 |
Il livello API Android minimo consentito. |
statusReportingSettings |
Impostazioni di generazione dei report sullo stato |
bluetoothContactSharingDisabled |
Indica se la condivisione dei contatti tramite Bluetooth è disattivata. |
shortSupportMessage |
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 |
Un messaggio visualizzato dall'utente nella schermata delle impostazioni degli amministratori del dispositivo. |
passwordRequirements |
Requisiti per le password. Il campo Nota: Qui non è possibile utilizzare i valori basati sulla complessità di |
wifiConfigsLockdownEnabled |
Questa opzione è deprecata. |
bluetoothConfigDisabled |
Indica se la configurazione del Bluetooth è disattivata. |
cellBroadcastsConfigDisabled |
Indica se la configurazione di cell broadcast è disattivata. |
credentialsConfigDisabled |
Indica se la configurazione delle credenziali utente è disattivata. |
mobileNetworksConfigDisabled |
Indica se la configurazione delle reti mobile è disattivata. |
tetheringConfigDisabled |
Indica se la configurazione del tethering e degli hotspot portatili è disabilitata. Se |
vpnConfigDisabled |
Indica se la configurazione della VPN è disattivata. |
wifiConfigDisabled |
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 |
createWindowsDisabled |
Indica se la creazione di finestre diverse da quelle delle app è disattivata. |
networkResetDisabled |
Indica se il ripristino delle impostazioni di rete è disattivato. |
outgoingBeamDisabled |
Se l'utilizzo di NFC per trasferire dati dalle app è disattivato. |
outgoingCallsDisabled |
Se le chiamate in uscita sono disattivate. |
removeUserDisabled |
Indica se la rimozione di altri utenti è disattivata. |
shareLocationDisabled |
Se la condivisione della posizione è disattivata. |
smsDisabled |
Se l'invio e la ricezione di SMS sono disabilitati. |
unmuteMicrophoneDisabled |
Se |
usbFileTransferDisabled |
Indica se il trasferimento di file tramite USB è disabilitato. Questa opzione è supportata solo sui dispositivi di proprietà dell'azienda. |
ensureVerifyAppsEnabled |
Indica se la verifica dell'app è abilitata forzatamente. |
permittedInputMethods |
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[] |
Le modalità di alimentazione a batteria per cui il dispositivo rimane acceso. Quando utilizzi questa impostazione, ti consigliamo di disattivare |
recommendedGlobalProxy |
Il proxy HTTP globale indipendente dalla rete. In genere, i proxy devono essere configurati per rete in |
setUserIconDisabled |
Indica se la modifica dell'icona utente è disattivata. Questo vale solo per i dispositivi con Android 7 e versioni successive. |
setWallpaperDisabled |
Indica se la modifica dello sfondo è disattivata. |
choosePrivateKeyRules[] |
Regole per determinare l'accesso delle app alle chiavi private. Per ulteriori dettagli, consulta |
alwaysOnVpnPackage |
Configurazione per una connessione VPN sempre attiva. Utilizza |
frpAdminEmails[] |
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 |
Le informazioni del proprietario del dispositivo da mostrare nella schermata di blocco. |
dataRoamingDisabled |
Indica se i servizi di dati in roaming sono disattivati. |
locationMode |
Il grado di rilevamento della posizione attivato. |
networkEscapeHatchEnabled |
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 |
bluetoothDisabled |
Indica se il Bluetooth è disattivato. Preferisci questa impostazione a |
complianceRules[] |
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 |
Se l'installazione di applicazioni diverse da quelle configurate in |
installUnknownSourcesAllowed |
Questo campo non ha alcun effetto. |
debuggingFeaturesAllowed |
Indica se all'utente è consentito attivare le funzionalità di debug. |
funDisabled |
Indica se l'utente è autorizzato a divertirsi. Controlla se il gioco Easter Egg nelle Impostazioni è disattivato. |
autoTimeRequired |
Se l'ora automatica è obbligatoria, il che impedisce all'utente di impostare manualmente la data e l'ora. Se |
permittedAccessibilityServices |
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 |
Alternativa consigliata: Quando Le norme sugli aggiornamenti automatici delle app, che controllano quando è possibile applicare gli aggiornamenti automatici delle app. |
kioskCustomLauncherEnabled |
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 |
androidDevicePolicyTracks[] |
Questa impostazione non è supportata. Qualsiasi valore viene ignorato. |
skipFirstUseHintsEnabled |
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 |
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 |
encryptionPolicy |
Se la crittografia è attivata |
usbMassStorageEnabled |
Indica se l'archivio USB è abilitato. Deprecato. |
permissionGrants[] |
Autorizzazione o concessione o rifiuto esplicito per tutte le app. Questi valori sostituiscono |
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[] |
Azione da intraprendere durante la procedura di configurazione. Può essere specificata al massimo un'azione. |
passwordPolicies[] |
Criteri per i requisiti delle password. È possibile impostare criteri diversi per il profilo di lavoro o per i dispositivi completamente gestiti impostando il campo |
policyEnforcementRules[] |
Regole che definiscono il comportamento quando una determinata norma non può essere applicata sul dispositivo |
kioskCustomization |
Impostazioni che controllano il comportamento di un dispositivo in modalità kiosk. Per attivare la modalità kiosk, imposta |
advancedSecurityOverrides |
Impostazioni di sicurezza avanzate. Nella maggior parte dei casi, non è necessario impostarli. |
personalUsagePolicies |
Norme che gestiscono l'utilizzo personale su un dispositivo di proprietà aziendale. |
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, |
oncCertificateProviders[] |
Questa funzionalità non è disponibile a livello generale. |
crossProfilePolicies |
Criteri cross-profile applicati sul dispositivo. |
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 |
usageLog |
Configurazione del logging delle attività del dispositivo. |
cameraAccess |
Controlla l'utilizzo della videocamera e se l'utente ha accesso al pulsante di attivazione/disattivazione dell'accesso alla videocamera. |
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 |
Include i controlli per la connettività del dispositivo, ad esempio Wi-Fi, accesso ai dati USB, connessioni tastiera/mouse e altro ancora. |
deviceRadioState |
Copre i controlli per lo stato della radio, come Wi-Fi, Bluetooth e altro ancora. |
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 |
printingPolicy |
Facoltativo. Controlla se la stampa è consentita. Questa funzionalità è supportata sui dispositivi con Android 9 e versioni successive. . |
displaySettings |
Facoltativo. Controlli per le impostazioni di visualizzazione. |
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 |
Facoltativo. Controlla la configurazione dell'account di lavoro, ad esempio i dettagli relativi alla necessità di un account autenticato da Google. |
wipeDataFlags[] |
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 |
enterpriseDisplayNameVisibility |
Facoltativo. Controlla se il |
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[] |
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 Per maggiori dettagli, consulta la guida Impostazioni predefinite dell'applicazione. |
ApplicationPolicy
| Rappresentazione JSON |
|---|
{ "packageName": string, "installType": enum ( |
| Campi | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
packageName |
Il nome del pacchetto dell'app. Ad esempio, |
||||||||||||||||
installType |
Il tipo di installazione da eseguire. |
||||||||||||||||
lockTaskAllowed |
Indica se l'app può bloccarsi in modalità a schermo intero. OBSOLETO. Utilizza InstallType |
||||||||||||||||
defaultPermissionPolicy |
Il criterio predefinito per tutte le autorizzazioni richieste dall'app. Se specificato, questo criterio sostituisce |
||||||||||||||||
permissionGrants[] |
Concessioni o negazioni esplicite di autorizzazioni per l'app. Questi valori sostituiscono |
||||||||||||||||
managedConfiguration |
Configurazione gestita applicata all'app. Il formato della configurazione è determinato dai valori
|
||||||||||||||||
disabled |
Indica se l'app è disattivata. Se disattivata, i dati dell'app vengono comunque conservati. |
||||||||||||||||
minimumVersionCode |
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 |
||||||||||||||||
delegatedScopes[] |
Gli ambiti delegati all'app da Android Device Policy. Questi forniscono privilegi aggiuntivi per le applicazioni a cui vengono applicati. |
||||||||||||||||
managedConfigurationTemplate |
Il modello di configurazioni gestite per l'app, salvato dall'iframe delle configurazioni gestite. Questo campo viene ignorato se è impostato managed_configuration. |
||||||||||||||||
accessibleTrackIds[] |
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 |
Controlla se l'app può comunicare con se stessa nei profili di lavoro e personali di un dispositivo, previo consenso dell'utente. |
||||||||||||||||
autoUpdateMode |
Controlla la modalità di aggiornamento automatico per l'app. |
||||||||||||||||
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 L'impronta del certificato della chiave di firma dell'app sul dispositivo deve corrispondere a una delle voci in |
||||||||||||||||
alwaysOnVpnLockdownExemption |
Specifica se l'app può accedere alla rete quando la VPN non è connessa e |
||||||||||||||||
workProfileWidgets |
Specifica se l'app installata nel profilo di lavoro può aggiungere widget alla schermata Home. |
||||||||||||||||
credentialProviderPolicy |
Facoltativo. Se l'app può fungere da fornitore di credenziali su Android 14 e versioni successive. |
||||||||||||||||
customAppConfig |
Facoltativo. Configurazione per questa app personalizzata.
|
||||||||||||||||
installConstraint[] |
Facoltativo. I vincoli per l'installazione dell'app. Puoi specificare un massimo di un |
||||||||||||||||
installPriority |
Facoltativo. Tra le app con
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 |
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 |
||||||||||||||||
preferentialNetworkId |
Facoltativo. ID della rete preferenziale utilizzata dall'applicazione. Deve esistere una configurazione per l'ID rete specificato in |
||||||||||||||||
signingKeyCerts[] |
Facoltativo. Certificati della chiave di firma dell'app. Questo campo è obbligatorio nei seguenti casi:
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 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:
|
||||||||||||||||
roles[] |
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 L'app riceve una notifica dei ruoli impostati se dispone di un servizio di ricezione delle notifiche con 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 Non devono essere presenti ruoli duplicati con lo stesso |
||||||||||||||||
PermissionGrant
| Rappresentazione JSON |
|---|
{
"permission": string,
"policy": enum ( |
| Campi | |
|---|---|
permission |
L'autorizzazione o il gruppo Android, ad esempio |
policy |
Il criterio per la concessione dell'autorizzazione. |
Struct
| Rappresentazione JSON |
|---|
{ "fields": { string: value, ... } } |
| Campi | |
|---|---|
fields |
Mappa non ordinata di valori digitati dinamicamente. Un oggetto contenente un elenco di coppie |
FieldsEntry
| Rappresentazione JSON |
|---|
{ "key": string, "value": value } |
| Campi | |
|---|---|
key |
|
value |
|
Valore
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione kind. Il tipo di valore. kind può essere solo uno dei seguenti tipi: |
|
nullValue |
Rappresenta un valore null. |
numberValue |
Rappresenta un valore doppio. |
stringValue |
Rappresenta un valore stringa. |
boolValue |
Rappresenta un valore booleano. |
structValue |
Rappresenta un valore strutturato. |
listValue |
Rappresenta un |
ListValue
| Rappresentazione JSON |
|---|
{ "values": [ value ] } |
| Campi | |
|---|---|
values[] |
Campo ripetuto di valori con tipo dinamico. |
ManagedConfigurationTemplate
| Rappresentazione JSON |
|---|
{ "templateId": string, "configurationVariables": { string: string, ... } } |
| Campi | |
|---|---|
templateId |
L'ID del modello di configurazioni gestite. |
configurationVariables |
(Facoltativo) Una mappa contenente le variabili di configurazione <chiave, valore> definite per la configurazione. Un oggetto contenente un elenco di coppie |
ConfigurationVariablesEntry
| Rappresentazione JSON |
|---|
{ "key": string, "value": string } |
| Campi | |
|---|---|
key |
|
value |
|
ExtensionConfig
| Rappresentazione JSON |
|---|
{ "signingKeyFingerprintsSha256": [ string ], "notificationReceiver": string } |
| Campi | |
|---|---|
signingKeyFingerprintsSha256[] |
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 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 |
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 |
CustomAppConfig
| Rappresentazione JSON |
|---|
{
"userUninstallSettings": enum ( |
| Campi | |
|---|---|
userUninstallSettings |
Facoltativo. Impostazioni di disinstallazione dell'utente dell'app personalizzata. |
InstallConstraint
| Rappresentazione JSON |
|---|
{ "networkTypeConstraint": enum ( |
| Campi | |
|---|---|
networkTypeConstraint |
Facoltativo. Vincolo del tipo di rete. |
chargingConstraint |
Facoltativo. Vincolo di ricarica. |
deviceIdleConstraint |
Facoltativo. Vincolo di inattività del dispositivo. |
ApplicationSigningKeyCert
| Rappresentazione JSON |
|---|
{ "signingKeyCertFingerprintSha256": string } |
| Campi | |
|---|---|
signingKeyCertFingerprintSha256 |
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 ( |
| Campi | |
|---|---|
roleType |
Obbligatorio. Il tipo di ruolo che un'app può avere. |
PersistentPreferredActivity
| Rappresentazione JSON |
|---|
{ "receiverActivity": string, "actions": [ string ], "categories": [ string ] } |
| Campi | |
|---|---|
receiverActivity |
L'attività che deve essere il gestore di intent predefinito. Deve essere un nome di componente Android, ad esempio |
actions[] |
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[] |
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 ( |
| Campi | |
|---|---|
type |
Il tipo di aggiornamento di sistema da configurare. |
startMinutes |
Se il tipo è |
endMinutes |
Se il tipo è |
allowedDaysWithoutUpdate |
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[] |
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 ( |
| Campi | |
|---|---|
startDate |
La data di inizio (inclusa) del periodo di blocco. Nota: è necessario impostare |
endDate |
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 |
Data
| Rappresentazione JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Campi | |
|---|---|
year |
L'anno della data. Deve essere compreso tra 1 e 9999 o tra 0 e 9999 per specificare una data senza anno. |
month |
Mese dell'anno. Deve essere compreso tra 1 e 12 o 0 per specificare un anno senza mese e giorno. |
day |
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 ( |
| Campi | |
|---|---|
applicationReportsEnabled |
Indica se i report delle app sono attivati. |
deviceSettingsEnabled |
Indica se la generazione di report sulle impostazioni del dispositivo è attivata. |
softwareInfoEnabled |
Se il reporting delle informazioni sul software è attivato. |
memoryInfoEnabled |
Indica se è attivato il reporting degli eventi di memoria. |
networkInfoEnabled |
Se il report sulle informazioni sulla rete è attivato. |
displayInfoEnabled |
Se è attivato il reporting delle visualizzazioni. I dati dei report non sono disponibili per i dispositivi di proprietà personale con profili di lavoro. |
powerManagementEventsEnabled |
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 |
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 |
Indica se i report sulle proprietà di sistema sono attivati. |
applicationReportingSettings |
Impostazioni di generazione dei report dell'applicazione. Applicabile solo se application_reports_enabled è true. |
commonCriteriaModeEnabled |
Indica se il reporting di |
defaultApplicationInfoReportingEnabled |
Facoltativo. Indica se il reporting di |
ApplicationReportingSettings
| Rappresentazione JSON |
|---|
{ "includeRemovedApps": boolean } |
| Campi | |
|---|---|
includeRemovedApps |
Se le app rimosse sono incluse nei report sulle applicazioni. |
UserFacingMessage
| Rappresentazione JSON |
|---|
{ "localizedMessages": { string: string, ... }, "defaultMessage": string } |
| Campi | |
|---|---|
localizedMessages |
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 |
defaultMessage |
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 |
|
value |
|
PasswordRequirements
| Rappresentazione JSON |
|---|
{ "passwordMinimumLength": integer, "passwordMinimumLetters": integer, "passwordMinimumLowerCase": integer, "passwordMinimumNonLetter": integer, "passwordMinimumNumeric": integer, "passwordMinimumSymbols": integer, "passwordMinimumUpperCase": integer, "passwordQuality": enum ( |
| Campi | |
|---|---|
passwordMinimumLength |
La lunghezza minima consentita della password. Un valore pari a 0 indica che non esiste alcuna limitazione. Applicato solo quando |
passwordMinimumLetters |
Numero minimo di lettere richieste nella password. Applicato solo quando |
passwordMinimumLowerCase |
Numero minimo di lettere minuscole richieste nella password. Applicato solo quando |
passwordMinimumNonLetter |
Numero minimo di caratteri che non siano lettere (cifre numeriche o simboli) richiesti nella password. Applicato solo quando |
passwordMinimumNumeric |
Numero minimo di cifre numeriche richieste nella password. Applicato solo quando |
passwordMinimumSymbols |
Numero minimo di simboli richiesti nella password. Applicato solo quando |
passwordMinimumUpperCase |
Numero minimo di lettere maiuscole richieste nella password. Applicato solo quando |
passwordQuality |
La qualità della password richiesta. |
passwordHistoryLength |
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 |
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 |
Timeout scadenza password. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
passwordScope |
L'ambito a cui si applica il requisito della password. |
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 |
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 |
Durata
| Rappresentazione JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campi | |
|---|---|
seconds |
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 |
Frazioni di secondo con segno con risoluzione in nanosecondi dell'intervallo di tempo. Le durate inferiori a un secondo sono rappresentate con un campo |
PackageNameList
| Rappresentazione JSON |
|---|
{ "packageNames": [ string ] } |
| Campi | |
|---|---|
packageNames[] |
Un elenco di nomi di pacchetto. |
ProxyInfo
| Rappresentazione JSON |
|---|
{ "host": string, "port": integer, "excludedHosts": [ string ], "pacUri": string } |
| Campi | |
|---|---|
host |
L'host del proxy diretto. |
port |
La porta del proxy diretto. |
excludedHosts[] |
Per un proxy diretto, gli host per cui il proxy viene ignorato. I nomi host possono contenere caratteri jolly come *.example.com. |
pacUri |
L'URI dello script PAC utilizzato per configurare il proxy. |
ChoosePrivateKeyRule
| Rappresentazione JSON |
|---|
{ "urlPattern": string, "packageNames": [ string ], "privateKeyAlias": string } |
| Campi | |
|---|---|
urlPattern |
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 |
packageNames[] |
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 |
privateKeyAlias |
L'alias della chiave privata da utilizzare. |
AlwaysOnVpnPackage
| Rappresentazione JSON |
|---|
{ "packageName": string, "lockdownEnabled": boolean } |
| Campi | |
|---|---|
packageName |
Il nome del pacchetto dell'app VPN. |
lockdownEnabled |
Non consente il networking quando la VPN non è connessa. |
ComplianceRule
| Rappresentazione JSON |
|---|
{ "disableApps": boolean, "packageNamesToDisable": [ string ], // Union field |
| Campi | |
|---|---|
disableApps |
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[] |
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 |
Una condizione soddisfatta se esiste qualsiasi |
apiLevelCondition |
Una condizione soddisfatta se il livello API Android Framework sul dispositivo non soddisfa un requisito minimo. |
NonComplianceDetailCondition
| Rappresentazione JSON |
|---|
{
"settingName": string,
"nonComplianceReason": enum ( |
| Campi | |
|---|---|
settingName |
Il nome dell'impostazione del criterio. Questo è il nome del campo JSON di un campo |
nonComplianceReason |
Il motivo per cui il dispositivo non è conforme all'impostazione. Se non è impostata, questa condizione corrisponde a qualsiasi motivo. |
packageName |
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 |
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 ( |
| Campi | |
|---|---|
title |
Titolo di questa azione. |
description |
Descrizione di questa azione. |
Campo unione action. L'azione da eseguire durante la configurazione. action può essere solo uno dei seguenti tipi: |
|
launchApp |
Un'azione per avviare un'app. L'app verrà avviata con un intent contenente un extra con la chiave |
LaunchAppAction
| Rappresentazione JSON |
|---|
{ // Union field |
| Campi | |
|---|---|
Campo unione
|
|
packageName |
Nome del pacchetto dell'app da avviare |
PolicyEnforcementRule
| Rappresentazione JSON |
|---|
{ "blockAction": { object ( |
| Campi | |
|---|---|
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 |
Un'azione per ripristinare un dispositivo di proprietà dell'azienda o eliminare un profilo di lavoro. Nota: è necessario specificare anche |
Campo unione trigger. Condizione che attiverà questa regola. trigger può essere solo uno dei seguenti tipi: |
|
settingName |
La policy di primo livello da applicare. Ad esempio, |
BlockAction
| Rappresentazione JSON |
|---|
{
"blockAfterDays": integer,
"blockScope": enum ( |
| Campi | |
|---|---|
blockAfterDays |
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. |
blockScope |
Specifica l'ambito di questo |
WipeAction
| Rappresentazione JSON |
|---|
{ "wipeAfterDays": integer, "preserveFrp": boolean } |
| Campi | |
|---|---|
wipeAfterDays |
Numero di giorni di non conformità alle norme prima della cancellazione dei dati del dispositivo o del profilo di lavoro. |
preserveFrp |
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 ( |
| Campi | |
|---|---|
powerButtonActions |
Imposta il comportamento di un dispositivo in modalità Kiosk quando un utente preme a lungo il tasto di accensione. |
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 |
Specifica quali funzionalità di navigazione sono attive (ad es. pulsanti Home e Panoramica) in modalità kiosk. |
statusBar |
Specifica se le informazioni di sistema e le notifiche sono disattivate in modalità kiosk. |
deviceSettings |
Specifica se l'app Impostazioni è consentita in modalità kiosk. |
AdvancedSecurityOverrides
| Rappresentazione JSON |
|---|
{ "untrustedAppsPolicy": enum ( |
| Campi | |
|---|---|
untrustedAppsPolicy |
Il criterio per le app non attendibili (app di origini sconosciute) applicato sul dispositivo. Sostituisce |
googlePlayProtectVerifyApps |
Indica se è applicata la verifica di Google Play Protect. Sostituisce |
developerSettings |
Controlla l'accesso alle impostazioni sviluppatore: opzioni sviluppatore e avvio sicuro. Sostituisce |
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 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[] |
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 |
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 |
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 ( |
| Campi | |
|---|---|
cameraDisabled |
Se è vero, la videocamera è disattivata nel profilo personale. |
screenCaptureDisabled |
Se è impostato su true, l'acquisizione dello schermo è disattivata per tutti gli utenti. |
accountTypesWithManagementDisabled[] |
Tipi di account che non possono essere gestiti dall'utente. |
maxDaysWithWorkOff |
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:
|
personalPlayStoreMode |
Utilizzato insieme a |
personalApplications[] |
Norme applicate alle applicazioni nel profilo personale. |
privateSpacePolicy |
Facoltativo. Controlla se è consentito uno spazio privato sul dispositivo. |
bluetoothSharing |
Facoltativo. Indica se la condivisione Bluetooth è consentita. |
PersonalApplicationPolicy
| Rappresentazione JSON |
|---|
{
"packageName": string,
"installType": enum ( |
| Campi | |
|---|---|
packageName |
Il nome del pacchetto dell'applicazione. |
installType |
Il tipo di installazione da eseguire. |
OncCertificateProvider
| Rappresentazione JSON |
|---|
{ "certificateReferences": [ string ], // Union field |
| Campi | |
|---|---|
certificateReferences[] |
Questa funzionalità non è disponibile a livello generale. |
Campo unione Questa funzionalità non è disponibile a livello generale. |
|
contentProviderEndpoint |
Questa funzionalità non è disponibile a livello generale. |
ContentProviderEndpoint
| Rappresentazione JSON |
|---|
{ "uri": string, "packageName": string, "signingCertsSha256": [ string ] } |
| Campi | |
|---|---|
uri |
Questa funzionalità non è disponibile a livello generale. |
packageName |
Questa funzionalità non è disponibile a livello generale. |
signingCertsSha256[] |
Obbligatorio. Questa funzionalità non è disponibile a livello generale. |
CrossProfilePolicies
| Rappresentazione JSON |
|---|
{ "showWorkContactsInPersonalProfile": enum ( |
| Campi | |
|---|---|
showWorkContactsInPersonalProfile |
Se le app personali possono accedere ai contatti memorizzati nel profilo di lavoro. Vedi anche |
crossProfileCopyPaste |
Se il testo copiato da un profilo (personale o di lavoro) può essere incollato nell'altro profilo. |
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 |
Specifica il comportamento predefinito per i widget del profilo di lavoro. Se il criterio non specifica |
crossProfileAppFunctions |
Facoltativo. Controlla se le app del profilo personale possono richiamare le funzioni delle app esposte dalle app nel profilo di lavoro. |
exemptionsToShowWorkContactsInPersonalProfile |
Elenco delle app escluse dall'impostazione
Supportato su Android 14 e versioni successive. Viene segnalato un |
UsageLog
| Rappresentazione JSON |
|---|
{ "enabledLogTypes": [ enum ( |
| Campi | |
|---|---|
enabledLogTypes[] |
Specifica i tipi di log abilitati. Tieni presente che gli utenti riceveranno messaggi sul dispositivo quando la registrazione dell'utilizzo è attiva. |
uploadOnCellularAllowed[] |
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 ( |
| Campi | |
|---|---|
usbDataAccess |
Controlla quali file e/o dati possono essere trasferiti tramite USB. Supportato solo sui dispositivi di proprietà dell'azienda. |
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 |
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 |
Controlla le impostazioni di tethering. In base al valore impostato, all'utente è vietato parzialmente o completamente l'utilizzo di diverse forme di tethering. |
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 |
Facoltativo. Norme di roaming Wi-Fi. |
bluetoothSharing |
Facoltativo. Controlla se la condivisione Bluetooth è consentita. |
preferentialNetworkServiceSettings |
Facoltativo. Configurazione preferenziale del servizio di rete. L'impostazione di questo campo sostituirà |
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 |
WifiSsidPolicy
| Rappresentazione JSON |
|---|
{ "wifiSsidPolicyType": enum ( |
| Campi | |
|---|---|
wifiSsidPolicyType |
Tipo di norma SSID Wi-Fi da applicare. |
wifiSsids[] |
Facoltativo. Elenco degli SSID Wi-Fi da applicare nelle norme. Questo campo non può essere vuoto quando WifiSsidPolicyType è impostato su |
WifiSsid
| Rappresentazione JSON |
|---|
{ "wifiSsid": string } |
| Campi | |
|---|---|
wifiSsid |
Obbligatorio. SSID Wi-Fi rappresentato come stringa. |
WifiRoamingPolicy
| Rappresentazione JSON |
|---|
{
"wifiRoamingSettings": [
{
object ( |
| Campi | |
|---|---|
wifiRoamingSettings[] |
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 ( |
| Campi | |
|---|---|
wifiSsid |
Obbligatorio. SSID della rete Wi-Fi. |
wifiRoamingMode |
Obbligatorio. Modalità di roaming Wi-Fi per l'SSID specificato. |
PreferentialNetworkServiceSettings
| Rappresentazione JSON |
|---|
{ "preferentialNetworkServiceConfigs": [ { object ( |
| Campi | |
|---|---|
preferentialNetworkServiceConfigs[] |
Obbligatorio. Configurazioni preferenziali dei servizi di rete che consentono di avere più slice aziendali. Non devono esistere più configurazioni con lo stesso |
defaultPreferentialNetworkId |
Obbligatorio. ID rete preferenziale predefinito per le applicazioni che non si trovano in
|
PreferentialNetworkServiceConfig
| Rappresentazione JSON |
|---|
{ "preferentialNetworkId": enum ( |
| Campi | |
|---|---|
preferentialNetworkId |
Obbligatorio. Identificatore di rete preferenziale. Questo valore non deve essere impostato su |
fallbackToDefaultConnection |
Facoltativo. Indica se è consentito il fallback alla rete predefinita a livello di dispositivo. Se questo criterio è impostato su |
nonMatchingNetworks |
Facoltativo. Se le app a cui si applica questa configurazione non possono utilizzare reti diverse dal servizio preferenziale. Se questo valore è impostato su |
ApnPolicy
| Rappresentazione JSON |
|---|
{ "overrideApns": enum ( |
| Campi | |
|---|---|
overrideApns |
Facoltativo. Indica se gli APN di override sono disattivati o attivati. Per maggiori dettagli, consulta |
apnSettings[] |
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
| Rappresentazione JSON |
|---|
{ "apnTypes": [ enum ( |
| Campi | |
|---|---|
apnTypes[] |
Obbligatorio. Categorie di utilizzo per l'APN. La norma verrà rifiutata se questo campo è vuoto o contiene |
apn |
Obbligatorio. Nome dell'APN. La policy verrà rifiutata se questo campo è vuoto. |
displayName |
Obbligatorio. Nome leggibile che descrive l'APN. La policy verrà rifiutata se questo campo è vuoto. |
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 |
Facoltativo. Tipo di autenticazione dell'APN. |
carrierId |
Facoltativo. ID operatore per l'APN. Un valore pari a 0 (impostazione predefinita) indica che non è impostato e i valori negativi vengono rifiutati. |
mmsProxyAddress |
Facoltativo. Indirizzo proxy MMS (Multimedia Messaging Service) dell'APN, che può essere un indirizzo IP o un nome host (non un URL). |
mmsProxyPort |
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 |
Facoltativo. URI MMSC (Multimedia Messaging Service Center) dell'APN. |
mtuV4 |
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 |
mtuV6 |
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 |
mvnoType |
Facoltativo. Tipo di corrispondenza MVNO per l'APN. |
networkTypes[] |
Facoltativo. Tecnologie radio (tipi di rete) che l'APN può utilizzare. La policy verrà rifiutata se questo campo contiene |
username |
Facoltativo. Nome utente APN dell'APN. |
password |
Facoltativo. Password APN dell'APN. |
numericOperatorId |
Facoltativo. L'ID operatore numerico dell'APN. L'ID operatore numerico è definito come MCC (Mobile Country Code) + MNC (Mobile Network Code). |
protocol |
Facoltativo. Il protocollo da utilizzare per connettersi a questo APN. |
roamingProtocol |
Facoltativo. Il protocollo da utilizzare per connettersi a questo APN mentre il dispositivo è in roaming. |
proxyAddress |
Facoltativo. L'indirizzo proxy dell'APN. |
proxyPort |
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 ( |
| Campi | |
|---|---|
wifiState |
Controlla lo stato attuale del Wi-Fi e se l'utente può modificarlo. |
airplaneModeState |
Controlla se la modalità aereo può essere attivata o disattivata dall'utente. |
ultraWidebandState |
Controlla lo stato dell'impostazione Ultra Wideband e se l'utente può attivarla o disattivarla. |
cellularTwoGState |
Controlla se l'impostazione 2G cellulare può essere attivata o disattivata dall'utente. |
minimumWifiSecurityLevel |
Il livello minimo di sicurezza richiesto delle reti Wi-Fi a cui il dispositivo può connettersi. |
userInitiatedAddEsimSettings |
Facoltativo. Controlla se l'utente è autorizzato ad aggiungere profili eSIM. |
DisplaySettings
| Rappresentazione JSON |
|---|
{ "screenBrightnessSettings": { object ( |
| Campi | |
|---|---|
screenBrightnessSettings |
Facoltativo. Controlla le impostazioni di luminosità dello schermo. |
screenTimeoutSettings |
Facoltativo. Controlla le impostazioni di spegnimento dello schermo. |
ScreenBrightnessSettings
| Rappresentazione JSON |
|---|
{
"screenBrightnessMode": enum ( |
| Campi | |
|---|---|
screenBrightnessMode |
Facoltativo. Controlla la modalità di luminosità dello schermo. |
screenBrightness |
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, |
ScreenTimeoutSettings
| Rappresentazione JSON |
|---|
{
"screenTimeoutMode": enum ( |
| Campi | |
|---|---|
screenTimeoutMode |
Facoltativo. Controlla se l'utente è autorizzato a configurare lo spegnimento dello schermo. |
screenTimeout |
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 Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
WorkAccountSetupConfig
| Rappresentazione JSON |
|---|
{
"authenticationType": enum ( |
| Campi | |
|---|---|
authenticationType |
Facoltativo. Il tipo di autenticazione dell'utente sul dispositivo. |
requiredAccountEmail |
Facoltativo. L'indirizzo email specifico dell'account Google Workspace da aggiungere. Questo campo è pertinente solo se |
DefaultApplicationSetting
| Rappresentazione JSON |
|---|
{ "defaultApplicationType": enum ( |
| Campi | |
|---|---|
defaultApplicationType |
Obbligatorio. Il tipo di app per impostare l'applicazione predefinita. |
defaultApplications[] |
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 Se Viene segnalato un Quando si applica a |
defaultApplicationScopes[] |
Obbligatorio. Gli ambiti a cui deve essere applicata la policy. Questo elenco non deve essere vuoto o contenere duplicati. Viene segnalato un |
DefaultApplication
| Rappresentazione JSON |
|---|
{ "packageName": string } |
| Campi | |
|---|---|
packageName |
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: ❌