---
title: API di gestione Android
slug: nmdm/admin-guide/it/vnow/api-di-gestione-android
createdAt: 2026-09-24T15:29:28.000Z
---

Android Management API (AMAPI) è l'API della piattaforma cloud di Google che integra le funzioni di Google Android UEM in Ivanti Neurons per MDM. Nella configurazione di Android Enterprise, è possibile attivare il framework dell'API di gestione Android per gestire i dispositivi Android Enterprise senza la necessità di installare un'app client sui dispositivi per la loro gestione. Attualmente, Go app non è supportato per il push al dispositivo per altre funzionalità come MTD, ecc.

Quando nella configurazione è impostato un account Android Enterprise, sarà possibile attivare e utilizzare il framework dell'API di gestione Android. Dopo l'attivazione, è possibile:

- Aggiungere un profilo di registrazione per utilizzare il codice QR per la registrazione dei dispositivi.
- Creare una configurazione dispositivo dedicata (monouso di proprietà aziendale, o COSU) per il dispositivo registrato che serva a uno scopo specifico.

L'API di gestione Android attualmente è supportata solo su dispositivi che eseguono Android versione 9 o superiore e che hanno Google Play installato e con provisioning in Modalità dedicata. La modalità Dedicata aziendale è anche indicata come modalità Monouso di proprietà dell'azienda (COSU) ed è una versione della modalità Proprietario del dispositivo. Questa funzione supporta anche le seguenti azioni del dispositivo:

- Blocca
- Riavvia
- Sincronizza su server
- Cancella

I check-in del dispositivo sono previsti a intervalli regolari (ogni ora). Per un intervento immediato, utilizzare l'azione del dispositivo "Sincronizza su server" nella pagina dei dettagli del dispositivo. I dispositivi AMAPI non inviano check-in obbligatori a Ivanti Neurons per MDM. Gli aggiornamenti di inventario vengono eseguiti se e quando viene svolta un'attività sul dispositivo.

## Attivazione dell'API di gestione Android

Per abilitare l'API Gestione Android, andare in **Amministratore > Android Enterprise > Autorizza Google (richiede un indirizzo Google valido) > Abilitazione Android Enterprise**.

Lo stato della funzionalità API Gestione Android abilitata (**Sì** per abilitata e **No** per disabilitata) è mostrato anche nella pagina Dettagli dispositivo.

:::hint{type="info"}
Gli account GSuite attualmente non sono supportati con COSU.
:::

## Aggiunta di un profilo di registrazione

È necessario creare un profilo di registrazione per registrare il dispositivo Android utilizzando la scansione del codice a barre o la stringa alfanumerica del token. I profili di registrazione possono essere creati solo se l'API di gestione Android è abilitata. È inoltre possibile creare attributi dei dispositivi personalizzati da associare al profilo di registrazione.

1. Selezionare **Amministratore > Android Enterprise > Profili di registrazione**.
2. Configurare le seguenti impostazioni nella finestra **Profilo di registrazione - Dispositivo dedicato di proprietà dell'azienda**.
3. Fare clic su **Salva**. La finestra **Riepilogo profilo** mostra i seguenti dettagli del token:

| **Impostazione**                         | **Descrizione**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                                 | Immettere un nome identificativo per il profilo di registrazione.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Descrizione**                          | Immettere una descrizione con cui spiegare lo scopo di questo profilo di registrazione.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Nome utente**                          | Inserire le prime lettere di un nome utente valido e selezionarlo dai risultati corrispondenti che vengono visualizzati.<br />Un nome utente valido potrebbe essere un utente locale o un utente LDAP.<br />I profili di registrazione contrassegnano i dispositivi registrati utilizzando il codice QR nel profilo da visualizzare come dispositivo appartenente all'utente per cui è stato creato il profilo di registrazione.                                                                                                                                                                                                                                                                                                                                        |
| **Validità token**                       | Inserire il numero di giorni di validità della scansione del codice QR del token di autenticazione. Il numero inserito deve essere compreso fra 1 e 30. Il dispositivo viene reimpostato se si utilizza il token o il profilo di registrazione dopo il periodo di scadenza.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **Attributi dispositivo personalizzati** | Nella colonna Azioni, fare clic su **+Aggiungi nuovo** per aggiungere attributi del dispositivo personalizzati da associare al profilo di registrazione.<br />1. Selezionare l'attributo del dispositivo personalizzato dall'elenco a discesa nella colonna **Nome attributo**.<br />2. Nella colonna **Valore**, immettere il valore dell'attributo personalizzato.<br />3. Fare clic su **Salva**. L'attributo del dispositivo personalizzato aggiunto viene visualizzato nella tabella. Per eliminarlo, fare clic su **Elimina** nella colonna Azioni.<br />Gli attributi personalizzati possono essere aggiunti a un profilo di registrazione solo durante la creazione del profilo. I campi attributo non possono essere modificati dopo la creazione del profilo. |

- Nome
- Descrizione
- Nome utente
- Data di creazione token
- Data di scadenza token
- Valore del token
- Codice QR
- Attributi dispositivo personalizzati.

:::hint{type="info"}
I dispositivi vengono reimpostati se non è possibile acquisire una configurazione corretta per il dispositivo entro un intervallo di tempo di 10 minuti dopo la registrazione. In questi casi, sarebbe necessario registrarsi di nuovo utilizzando il token di registrazione/codice QR
:::

Quando si crea un profilo di registrazione, questo viene indicato nella pagina **Profili di registrazione**. È possibile eseguire una qualsiasi delle seguenti azioni nella colonna **Azioni**.

- Fare clic sull'icona Visualizzazione per visualizzare i dettagli del profilo di registrazione nella finestra Riepilogo profilo. Anche il codice QR viene visualizzato in questa finestra.
- Fare clic sull'icona Modifica per modificare i dettagli del profilo di registrazione.

:::hint{type="info"}
È possibile modificare solo la validità del token. Altri attributi non possono essere modificati.
:::

Fare clic sull'icona Elimina per eliminare il profilo di registrazione.

## Creazione della configurazione COSU

Gli amministratori possono configurare i dispositivi dedicati che possono essere utilizzati per uno scopo specifico utilizzando Android Enterprise e la configurazione dei dispositivi dedicati (monouso di proprietà dell'azienda o COSU). La configurazione COSU viene distribuita ai dispositivi di lavoro gestiti (modalità Proprietario del dispositivo) per rendere disponibile una sola app per gli utenti in modalità tutto schermo. I dispositivi in modalità Profilo di lavoro su dispositivo di proprietà dell'azienda non sono supportati.

Con questa configurazione, l'amministratore può configurare i dispositivi in modo da bloccare l'app sullo schermo così che l'utente in modalità tutto schermo non possa sbloccarla e uscirne per passare ad altre schermate del dispositivo o utilizzare qualsiasi altra app sul dispositivo.

:::hint{type="info"}
Può essere inoltre forzata l'installazione di altre app sul dispositivo AMA selezionando l'opzione "Installa sul dispositivo" in Opzioni avanzate e Configurazione app, tuttavia l'utente non sarà in grado di interagire con tali app mentre l'app tutto schermo è bloccata sullo schermo tramite la configurazione. Per tutto schermo multi-app, si consiglia di utilizzare la funzionalità tutto schermo del dispositivo di lavoro gestito (modalità Proprietario del dispositivo). Ciò consente un maggior controllo sulle app e sulle impostazioni del dispositivo e può essere esteso a una modalità multi-utente.
:::

Gli amministratori possono apportare modifiche alla configurazione, come ad esempio consentire la navigazione di sistema e la possibilità di utilizzare altre app inviate al dispositivo per l'utente finale tramite Google DPC, esaminando le varie opzioni in base alle esigenze.

Le configurazioni COSU sono determinate dalla priorità loro assegnata. La configurazione con la massima priorità viene utilizzata nell'invio della configurazione delle policy a Google. Le configurazioni COSU vengono applicate ai dispositivi all'interno dello spazio definito. Possono essere delegate ad altri spazi, se definite nello spazio predefinito.

Per configurare:

1. Andare a **Configurazione > +Aggiungi**.
2. Nella **configurazione Blocco e tutto schermo: Android Enterprise**, fare clic su **Dispositivi dedicati (monouso di proprietà dell'azienda o COSU)**.
3. Immettere un nome per la configurazione.
4. Immettere una descrizione.
5. È possibile configurare le seguenti impostazioni facendo clic sulle schede pertinenti:

- **Impostazioni app**
- **Blocchi generali**
- **Personalizzazione tutto schermo**
- **Impostazioni di sistema**

La seguente tabella fornisce i dettagli dei campi configurabili:

| **Impostazione**                                     | **Descrizione**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Impostazione app**                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Nome app**                                         | Selezionare l'app da bloccare sul dispositivo digitando il nome dell'app (digitare la lettera iniziale del nome dell'app finché non compare l'app desiderata nel menu a discesa). Se l'app non viene visualizzata nel menu a discesa, assicurarsi che l'app che si desidera distribuire sia un'app privata/pubblica disponibile nel Play Store e sia aggiunta ad App Catalog.<br />Questo campo è obbligatorio. Non sarà permesso creare la configurazione se non si seleziona un'app da aggiungere in questo campo. È possibile aggiungere solo app pubbliche e private. Non è possibile aggiungere app interne e Web (private).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Blocchi generali**                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Tieni attivo display**                             | Configurare le modalità di collegamento batteria per l'alimentazione del dispositivo. Selezionare una delle seguenti opzioni:<br />- **AC** - La fonte di alimentazione è un caricabatterie AC<br />- **Wireless**<br />- **USB** - La fonte di alimentazione è una porta USB<br />- **Qualunque** - La fonte di alimentazione è un caricabatterie AC, una porta USB o un caricabatterie wireless.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Personalizzazione tutto schermo**                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Personalizza barra di stato**                      | Selezionare una delle seguenti opzioni per personalizzare la barra di stato sui dispositivi di destinazione:<br />- **Notifiche e informazioni di sistema attivate** - Per mostrare le informazioni di sistema e le notifiche sulla barra di stato.<br />- **Solo informazioni di sistema attivate** - Per visualizzare solo le informazioni di sistema sulla barra di stato.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Personalizza navigazione di sistema**              | Selezionare una delle seguenti opzioni per specificare l'accesso alle funzioni di navigazione (Home, e pulsanti Panoramica) in modalità tutto schermo:<br />- **Attivato** - Consente la navigazione dei pulsanti Home e Panoramica. Gli utenti possono uscire dall'app specificata se questa opzione è selezionata.<br />- **Disattivato** - Disabilita la navigazione dei pulsanti Home e Panoramica.<br />- **Solo pulsante Home** - Consente solo la navigazione del pulsante Home.<br />Il pulsante Indietro è disponibile con tutte queste opzioni.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Attiva azioni globali**                            | Selezionare per consentire le azioni globali in modalità tutto schermo. Le funzionalità di riavvio e arresto associate ai pulsanti di accensione sono controllate tramite questa opzione.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Attiva finestre di dialogo per errori di sistema** | Selezionare per consentire le finestre di dialogo per le app che restituiscono un errore o non rispondono in modalità tutto schermo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Impostazioni di sistema**                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Impostazioni aggiornamenti del sistema**           | Configurare le seguenti impostazioni per gestire gli aggiornamenti di sistema:<br />- **Aggiornamento del sistema** - Per selezionare il tipo di aggiornamento di sistema richiesto.<br />- **Automatico** - Installa automaticamente non appena è disponibile un aggiornamento.<br />- **Posticipa** - Per posticipare l'installazione automatica per un massimo di 30 giorni.<br />- **Con finestra** - Per installare automaticamente all'interno di una finestra di manutenzione quotidiana. Impostare le ore di inizio e di fine per il periodo della finestra di manutenzione.<br />Gli aggiornamenti installati sui dispositivi potrebbero variare in base al set di funzionalità supportato, alla versione di Android e alla versione di Google DPC installati sul dispositivo.<br />- **Periodo di blocco** - Quando un dispositivo si trova all'interno del periodo di blocco, tutti gli aggiornamenti di sistema in arrivo sono bloccati e non vengono installati. Fare clic su **Aggiungi periodo di blocco** per impostare la **Data d'inizio** e la **Data di fine** del periodo di blocco.<br />Quando un dispositivo è al di fuori del periodo di blocco, viene applicato il comportamento di aggiornamento normale. Se la data di fine è prima della data d'inizio, allora il periodo di blocco si estende tra l'anno corrente e quello successivo.<br />Il periodo di blocco può essere impostato per un massimo di 90 giorni. Due periodi di blocco consecutivi devono essere separati da un minimo di 60 giorni. |

6. Fare clic su **Avanti**.
7. Selezionare una delle seguenti opzioni di distribuzione:

- **Tutti i dispositivi**
- **Nessun dispositivo** (impostazione predefinita)
- **Personalizzato**

8. Fare clic su **Fine**.

### Gestione delle app su dispositivi AMAPI

Quando la configurazione COSU viene distribuita nei dispositivi, le app vengono inviate e bloccate sullo schermo sul dispositivo AMA. Indipendentemente dall'invio della configurazione COSU al dispositivo, le app installate sul dispositivo AMA possono ancora essere gestite. Di seguito sono riportati i dettagli sulla gestione delle app su questi dispositivi:

- Sono supportate solo le app pubbliche e private; le app interne e le clip Web non sono supportate.
- Le app vengono inviate solo se nelle impostazioni di installazione sono attivate le opzioni "Installa sul dispositivo" o "Installazione invisibile". Le app assegnate all'utente/dispositivo senza una di queste opzioni abilitate non saranno visibili sul dispositivo o nel Play Store del dispositivo per qualsiasi azione da parte dell'utente.
- Le configurazioni delle app supportate sono Google Play gestito e Impostazioni dispositivo di lavoro gestito (Android for Work). Sono supportate le configurazioni gestite per le app, compreso il supporto della configurazione gestita per le app OEMConfig.

:::hint{type="info"}
Il tempo per il completamento dell'installazione e della disinstallazione delle configurazioni potrebbe variare in base alle notifiche di Google (servizio di messaggistica) sull'esecuzione dell'azione desiderata.
:::

- Go app verrà ora installato per impostazione predefinita come parte della registrazione del dispositivo AMA. Durante la procedura di registrazione, l'app verrà bloccata a schermo e, una volta completata la configurazione, verrà eseguita in background.

:::hint{type="info"}
Le policy, fatta eccezione per l'applicazione del requisito di registrazione del dispositivo in base al produttore, la versione del sistema operativo e il livello delle patch di sicurezza non sono supportati. L'elenco dei dispositivi consentiti che permette solo ai dispositivi ammessi di registrarsi con Ivanti Neurons per MDM è supportato.
:::

### Gestione del supporto feedback app su dispositivi AMAPI

Il supporto feedback app può essere gestito su dispositivi AMAPI (COSU). Quando un dispositivo viene registrato in modalità AMAPI (COSU), la configurazione app gestita verrà inviata a Ivanti Neurons per MDM direttamente da Google senza alcun intervento da parte di Go app. Le informazioni di Feedback app gestite possono essere visualizzate a livello di dispositivo da **Dettagli dispositivo > App installate > Visualizza feedback**, oppure possono essere visualizzate a livello di singola app navigando alla specifica app Android nel Catalogo app sotto la scheda "Feedback configurazione app" per il report complessivo su tutti i dispositivi. Per informazioni sul meccanismo di feedback app, vedere [Sincronizzazione e recupero del feedback per un'app](docId:-DAHxwr5lQRnHt_a36sR5).

### Limitazioni AMAPI

Attualmente, AMAPI presenta i seguenti limiti:

- Sono supportati solo i dispositivi dedicati (modalità COSU).

### Configurazioni supportate

Le configurazioni seguenti sono supportate per AMAPI:

- Distribuzione app (app singole o multiple)
- Configurazione di app gestite per app inviate al dispositivo
- Configurazione Wi-Fi
- Configurazione (COSU) Dedicata/Blocco Android Enterprise
- Configurazione VPN Always-on
