DpcMigrationClient

Kotlin |Java

interface DpcMigrationClient

---

Client per effettuare richieste relative alla migrazione dpc.

Riepilogo

Funzioni pubbliche
ListenableFuture<DpcMigrationAttempt?>	getMigrationAttempt(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) Riceve un tentativo di migrazione.
suspend DpcMigrationAttempt?	getMigrationAttemptAwait(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) Riceve un tentativo di migrazione.
ListenableFuture<List<DpcMigrationAttempt>>	listMigrationAttempts() Restituisce un elenco di tutti i tentativi di migrazione.
suspend List<DpcMigrationAttempt>	listMigrationAttemptsAwait() Restituisce un elenco di tutti i tentativi di migrazione.
ListenableFuture<DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) Esegui la migrazione di questo dispositivo affinché sia gestito dall'API Android Management.
suspend DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) Esegui la migrazione di questo dispositivo affinché sia gestito dall'API Android Management.

Funzioni pubbliche

getMigrationAttempt

fun getMigrationAttempt(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
): ListenableFuture<DpcMigrationAttempt?>

Riceve un tentativo di migrazione.

Se non viene specificato alcun nome in GetDpcMigrationAttemptRequest, viene restituito il valore DpcMigrationAttempt più recente.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un proprietario precedente del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management.

Ritorni

ListenableFuture<DpcMigrationAttempt?>

Un ListenableFuture a capo del risultato. Può essere Un futuro con successo per l'invio di un DpcMigrationAttempt, in caso di successo. Un wrapping futuro riuscito è nullo nel caso in cui DpcMigrationAttempt non venga trovato. Impossibile eseguire il wrapping di SecurityException in futuro, nel caso in cui il chiamante non sia un proprietario del dispositivo o del profilo, oppure un proprietario precedente del dispositivo o del profilo di cui è stata eseguita la migrazione all'API Android Management. Wrapping futuro non riuscito DpcMigrationException Se la chiamata relativa alla migrazione dpc non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

getMigrationAttemptAwait

suspend fun getMigrationAttemptAwait(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
): DpcMigrationAttempt?

Riceve un tentativo di migrazione.

Se non viene specificato alcun nome in GetDpcMigrationAttemptRequest, viene restituito il valore DpcMigrationAttempt più recente.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un proprietario precedente del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management.

Ritorni
DpcMigrationAttempt?	Il valore DpcMigrationAttempt richiesto o nullo, se non è possibile trovarlo

Lanci
java.lang.SecurityException	Se il chiamante non è un proprietario del dispositivo o del profilo oppure un proprietario precedente del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Se la chiamata relativa alla migrazione dpc non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

listMigrationAttempts

fun listMigrationAttempts(): ListenableFuture<List<DpcMigrationAttempt>>

Restituisce un elenco di tutti i tentativi di migrazione.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un proprietario precedente del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management. Nota: i tentativi di migrazione meno recenti vengono eliminati automaticamente e non vengono restituiti.

Ritorni

ListenableFuture<List<DpcMigrationAttempt>>

Un ListenableFuture a capo del risultato. Può essere Un'operazione futura con esito positivo di un elenco di DpcMigrationAttempt, in caso di esito positivo. Impossibile eseguire il wrapping di SecurityException in futuro, nel caso in cui il chiamante non sia un proprietario del dispositivo o del profilo, oppure un proprietario precedente del dispositivo o del profilo di cui è stata eseguita la migrazione all'API Android Management. Wrapping futuro non riuscito DpcMigrationException Se la chiamata relativa alla migrazione dpc non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

listMigrationAttemptsAwait

suspend fun listMigrationAttemptsAwait(): List<DpcMigrationAttempt>

Restituisce un elenco di tutti i tentativi di migrazione.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un proprietario precedente del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management. Nota: i tentativi di migrazione meno recenti vengono eliminati automaticamente e non vengono restituiti.

Ritorni
List<DpcMigrationAttempt>	Un elenco di DpcMigrationAttempt

Lanci
java.lang.SecurityException	Se il chiamante non è un proprietario del dispositivo o del profilo oppure un proprietario precedente del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Se la chiamata relativa alla migrazione dpc non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

migrateDeviceManagementToAndroidManagementApi

fun migrateDeviceManagementToAndroidManagementApi(
    notificationServiceComponentName: ComponentName,
    adminComponentName: ComponentName,
    migrationRequest: DpcMigrationRequest
): ListenableFuture<DpcMigrationAttempt>

Esegui la migrazione di questo dispositivo affinché sia gestito dall'API Android Management.

Al termine della migrazione, l'app per le chiamate perde i privilegi Proprietario dispositivo o Proprietario del profilo, che vengono trasferiti ad Android Device Policy.

Attenzione: l'operazione non può essere annullata! Il valore AscoltaableFuture restituito viene completato quando Android Device Policy ha ricevuto la richiesta e ha completato i controlli preliminari del token di migrazione. In caso di errore, AscoltaableFuture aggrega un Exception.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o di un profilo. Su Android 10 e versioni precedenti, questa funzionalità non deve essere effettuata su un dispositivo che dispone sia di un proprietario del dispositivo sia di un proprietario del profilo.

Le reti Wi-Fi configurate devono essere trasmesse su DpcMigrationRequest dal proprietario del profilo (tranne su Android 12) su un dispositivo di proprietà personale, se sono state configurate delle reti Wi-Fi. Questi dati non devono essere trasmessi su un dispositivo di proprietà dell'azienda. Tieni presente che queste reti Wi-Fi verranno rimosse poco prima della migrazione della gestione dei dispositivi ad Android Device Policy. In caso di mancata rimozione di una rete, anche la migrazione avrà esito negativo e, poiché la rimozione delle reti non è un'operazione atomica, alcune reti potrebbero essere già state rimosse.

Sui dispositivi di proprietà personale con un profilo di lavoro con Android 12, tutte le reti Wi-Fi configurate dal DPC delle chiamate verranno rimosse poco prima della migrazione della gestione dei dispositivi ad Android Device Policy, indipendentemente dalle reti Wi-Fi trasmesse nel migrationRequest.

Parametri
notificationServiceComponentName: ComponentName	ComponentName del servizio che estende NotificationReceiverService. Deve essere un componente valido appartenente all'app di chiamata ed esportato nel manifest, altrimenti verrà generato un valore IllegalArgumentException.
adminComponentName: ComponentName	Il ComponentName dell'amministratore DeviceAdminReceiver del DPC chiamante.
migrationRequest: DpcMigrationRequest	Il campo DpcMigrationRequest contenente il token di migrazione e le reti Wi-Fi configurate. Queste ultime sono richieste solo se il chiamante è il proprietario del profilo su un dispositivo di proprietà personale e ha configurato delle reti.

Ritorni

ListenableFuture<DpcMigrationAttempt>

Un ListenableFuture a capo del risultato. Può essere Un futuro con successo per l'invio di un DpcMigrationAttempt, in caso di successo. Impossibile eseguire il wrapping di un SecurityException in futuro, se il chiamante non è un proprietario del dispositivo o del profilo. Un wrapping futuro di IllegalArgumentException non riuscito se il token di migrazione è vuoto o se notificationServiceComponentName non fa riferimento a un componente valido che estende NotificationReceiverService che viene esportato nel file manifest o se adminComponentName non è un amministratore attivo appartenente al pacchetto corrente. Impossibile eseguire il wrapping futuro di DpcMigrationException, se la chiamata relativa alla migrazione del VPC non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

migrateDeviceManagementToAndroidManagementApiAwait

suspend fun migrateDeviceManagementToAndroidManagementApiAwait(
    notificationServiceComponentName: ComponentName,
    adminComponentName: ComponentName,
    migrationRequest: DpcMigrationRequest
): DpcMigrationAttempt

Esegui la migrazione di questo dispositivo affinché sia gestito dall'API Android Management.

Al termine della migrazione, l'app per le chiamate perde i privilegi Proprietario dispositivo o Proprietario del profilo, che vengono trasferiti ad Android Device Policy.

Attenzione: l'operazione non può essere annullata! Questa operazione sospende il ritorno divertente quando Android Device Policy ha ricevuto la richiesta e ha completato i controlli preliminari del token di migrazione. In caso di errore, viene generato un valore Exception.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o di un profilo. Su Android 10 e versioni precedenti, questa funzionalità non deve essere effettuata su un dispositivo che dispone sia di un proprietario del dispositivo sia di un proprietario del profilo.

Le reti Wi-Fi configurate devono essere trasmesse su DpcMigrationRequest dal proprietario del profilo (tranne su Android 12) su un dispositivo di proprietà personale, se sono state configurate delle reti Wi-Fi. Questi dati non devono essere trasmessi su un dispositivo di proprietà dell'azienda. Tieni presente che queste reti Wi-Fi verranno rimosse poco prima della migrazione della gestione dei dispositivi ad Android Device Policy. In caso di mancata rimozione di una rete, anche la migrazione avrà esito negativo e, poiché la rimozione delle reti non è un'operazione atomica, alcune reti potrebbero essere già state rimosse.

Sui dispositivi di proprietà personale con un profilo di lavoro con Android 12, tutte le reti Wi-Fi configurate dal DPC delle chiamate verranno rimosse poco prima della migrazione della gestione dei dispositivi ad Android Device Policy, indipendentemente dalle reti Wi-Fi trasmesse nel migrationRequest.

Parametri
notificationServiceComponentName: ComponentName	ComponentName del servizio che estende NotificationReceiverService. Deve essere un componente valido appartenente all'app di chiamata ed esportato nel manifest, altrimenti verrà generato un valore IllegalArgumentException.
adminComponentName: ComponentName	Il ComponentName dell'amministratore DeviceAdminReceiver del DPC chiamante.
migrationRequest: DpcMigrationRequest	Il campo DpcMigrationRequest contenente il token di migrazione e le reti Wi-Fi configurate. Queste ultime sono richieste solo se il chiamante è il proprietario del profilo su un dispositivo di proprietà personale e ha configurato delle reti.

Ritorni
DpcMigrationAttempt	DpcMigrationException con lo stato attuale della migrazione in caso di esito positivo.

Lanci
java.lang.SecurityException	Se il chiamante non è un proprietario del dispositivo o del profilo.
java.lang.IllegalArgumentException	Se il token di migrazione è vuoto o se notificationServiceComponentName non fa riferimento a un componente valido che estende NotificationReceiverService, che viene esportato nel file manifest, oppure se adminComponentName non è un amministratore attivo appartenente al pacchetto corrente.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Se la chiamata relativa alla migrazione dpc non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.