DpcMigrationClient

public interface DpcMigrationClient

El cliente realiza solicitudes relacionadas con la migración de DPC.

Resumen

Métodos públicos
abstract @NonNull ListenableFuture<DpcMigrationAttempt>
getMigrationAttempt(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Obtiene un intento de migración.
abstract DpcMigrationAttempt
getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Obtiene un intento de migración.
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

Muestra una lista de todos los intentos de migración.
abstract @NonNull List<@NonNull DpcMigrationAttempt>

Muestra una lista de todos los intentos de migración.
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt>
migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Migra este dispositivo para que sea administrado por la API de Android Management.
abstract @NonNull DpcMigrationAttempt
migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Migra este dispositivo para que sea administrado por la API de Android Management.

Métodos públicos

getMigrationAttempt

abstract @NonNull ListenableFuture<DpcMigrationAttempt> getMigrationAttempt(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Obtiene un intento de migración.

Si no se especifica ningún nombre en GetDpcMigrationAttemptRequest, se muestra la DpcMigrationAttempt más reciente.

Solo el propietario del dispositivo o del perfil puede llamar a este método, o bien un propietario anterior del dispositivo o del perfil que migró a la API de Android Management.

Muestra
@NonNull ListenableFuture<DpcMigrationAttempt>

Un ListenableFuture que une el resultado. Puede ser

  • Un futuro exitoso que une un DpcMigrationAttempt, en caso de éxito.

  • Un valor nulo exitoso de unión futura, en caso de que no se encuentre DpcMigrationAttempt

  • Un futuro con errores en la unión de SecurityException, en caso de que el emisor no sea propietario del dispositivo o del perfil, o un propietario del dispositivo o del perfil anterior que haya migrado a la API de Android Management.

  • Una unión futura fallida de DpcMigrationException Si la llamada relacionada con la migración de DPC falló. El mensaje y el subtipo de la excepción contienen más detalles sobre el error.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Obtiene un intento de migración.

Si no se especifica ningún nombre en GetDpcMigrationAttemptRequest, se muestra la DpcMigrationAttempt más reciente.

Solo el propietario del dispositivo o del perfil puede llamar a este método, o bien un propietario anterior del dispositivo o del perfil que migró a la API de Android Management.

Muestra
DpcMigrationAttempt

El DpcMigrationAttempt solicitado o nulo, si no se puede encontrar
Arroja
java.lang.SecurityException

Si el emisor no es propietario del dispositivo, propietario del perfil o propietario del dispositivo o del perfil anterior que migró a la API de Android Management.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Si falló la llamada relacionada con la migración de DPC. El mensaje y el subtipo de la excepción contienen más detalles sobre el error.

listMigrationAttempts

abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> listMigrationAttempts()

Muestra una lista de todos los intentos de migración.

Solo el propietario del dispositivo o del perfil puede llamar a este método, o bien un propietario anterior del dispositivo o del perfil que migró a la API de Android Management. Nota: Los intentos de migración anteriores se borran automáticamente y no se devuelven.

Muestra
@NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

Un ListenableFuture que une el resultado. Puede ser

  • Un futuro exitoso que une una lista de DpcMigrationAttempt, en caso de éxito.

  • Un futuro con errores en la unión de SecurityException, en caso de que el emisor no sea propietario del dispositivo o del perfil, o un propietario del dispositivo o del perfil anterior que haya migrado a la API de Android Management.

  • Una unión futura fallida de DpcMigrationException Si la llamada relacionada con la migración de DPC falló. El mensaje y el subtipo de la excepción contienen más detalles sobre el error.

listMigrationAttemptsAwait

abstract @NonNull List<@NonNull DpcMigrationAttempt> listMigrationAttemptsAwait()

Muestra una lista de todos los intentos de migración.

Solo el propietario del dispositivo o del perfil puede llamar a este método, o bien un propietario anterior del dispositivo o del perfil que migró a la API de Android Management. Nota: Los intentos de migración anteriores se borran automáticamente y no se devuelven.

Muestra
@NonNull List<@NonNull DpcMigrationAttempt>

Una lista de DpcMigrationAttempt
Arroja
java.lang.SecurityException

Si el emisor no es propietario del dispositivo, propietario del perfil o propietario del dispositivo o del perfil anterior que migró a la API de Android Management.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Si falló la llamada relacionada con la migración de DPC. El mensaje y el subtipo de la excepción contienen más detalles sobre el error.

migrateDeviceManagementToAndroidManagementApi

abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt> migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Migra este dispositivo para que sea administrado por la API de Android Management.

Una vez que se complete la migración, la app que realiza la llamada perderá sus privilegios de propietario del dispositivo o del perfil, ya que estos se transfieren a Android Device Policy.

Advertencia: Esta acción no se puede deshacer. El ListenableFuture que se muestra se completa cuando Android Device Policy recibe la solicitud y completó las verificaciones preliminares del token de migración. En caso de que se produzca un error, ListenableFuture unirá una Exception.

Solo el propietario del dispositivo o del perfil puede llamar a este método. En Android 10 y versiones anteriores, no se debe llamar a esta función en un dispositivo con un propietario del dispositivo y un propietario del perfil.

El propietario del perfil debe pasar las redes Wi-Fi configuradas en DpcMigrationRequest (excepto en Android 12) en un dispositivo de propiedad personal si configuró alguna red Wi-Fi. Estos no se deben pasar en un dispositivo de la empresa. Ten en cuenta que estas redes Wi-Fi se quitarán justo antes de migrar la administración de dispositivos a Android Device Policy. En caso de no quitar una red, la migración también fallará y, dado que la eliminación de las redes no es una operación atómica, es posible que algunas ya se hayan quitado.

En dispositivos de propiedad personal con un perfil de trabajo que ejecute Android 12, se quitarán todas las redes Wi-Fi configuradas por el DPC de llamada justo antes de que se migre la administración de dispositivos a Android Device Policy, independientemente de las redes Wi-Fi que se pasen en migrationRequest.

Parámetros
@NonNull ComponentName notificationServiceComponentName

El ComponentName del servicio que extiende NotificationReceiverService. Debe ser un componente válido que pertenezca a la app que realiza la llamada y se debe exportar en el manifiesto; de lo contrario, se arrojará una IllegalArgumentException.
@NonNull ComponentName adminComponentName

El ComponentName del DeviceAdminReceiver del administrador del DPC que realiza la llamada.
@NonNull DpcMigrationRequest migrationRequest

El DpcMigrationRequest que contiene el token de migración y las redes Wi-Fi configuradas. Los últimos solo son necesarios si el emisor es el propietario del perfil en un dispositivo de propiedad personal y configuró alguna red.
Muestra
@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

Un ListenableFuture que une el resultado. Puede ser

migrateDeviceManagementToAndroidManagementApiAwait

abstract @NonNull DpcMigrationAttempt migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Migra este dispositivo para que sea administrado por la API de Android Management.

Una vez que se complete la migración, la app que realiza la llamada perderá sus privilegios de propietario del dispositivo o del perfil, ya que estos se transfieren a Android Device Policy.

Advertencia: Esta acción no se puede deshacer. Esta diversión de suspensión se muestra cuando Android Device Policy recibe la solicitud y completa las verificaciones preliminares del token de migración. En caso de fallar, se arroja una Exception.

Solo el propietario del dispositivo o del perfil puede llamar a este método. En Android 10 y versiones anteriores, no se debe llamar a esta función en un dispositivo con un propietario del dispositivo y un propietario del perfil.

El propietario del perfil debe pasar las redes Wi-Fi configuradas en DpcMigrationRequest (excepto en Android 12) en un dispositivo de propiedad personal si configuró alguna red Wi-Fi. Estos no se deben pasar en un dispositivo de la empresa. Ten en cuenta que estas redes Wi-Fi se quitarán justo antes de migrar la administración de dispositivos a Android Device Policy. En caso de no quitar una red, la migración también fallará y, dado que la eliminación de las redes no es una operación atómica, es posible que algunas ya se hayan quitado.

En dispositivos de propiedad personal con un perfil de trabajo que ejecute Android 12, se quitarán todas las redes Wi-Fi configuradas por el DPC de llamada justo antes de que se migre la administración de dispositivos a Android Device Policy, independientemente de las redes Wi-Fi que se pasen en migrationRequest.

Parámetros
@NonNull ComponentName notificationServiceComponentName

El ComponentName del servicio que extiende NotificationReceiverService. Debe ser un componente válido que pertenezca a la app que realiza la llamada y se debe exportar en el manifiesto; de lo contrario, se arrojará una IllegalArgumentException.
@NonNull ComponentName adminComponentName

El ComponentName del DeviceAdminReceiver del administrador del DPC que realiza la llamada.
@NonNull DpcMigrationRequest migrationRequest

El DpcMigrationRequest que contiene el token de migración y las redes Wi-Fi configuradas. Los últimos solo son necesarios si el emisor es el propietario del perfil en un dispositivo de propiedad personal y configuró alguna red.
Muestra
@NonNull DpcMigrationAttempt

DpcMigrationException por el estado actual de la migración en caso de que se complete correctamente.
Arroja
java.lang.SecurityException

Si el emisor no es propietario del dispositivo ni del perfil.
java.lang.IllegalArgumentException

Si el token de migración está vacío o si notificationServiceComponentName no hace referencia a un componente válido que extiende NotificationReceiverService que se exporta en el manifiesto, o si adminComponentName no es un administrador activo que pertenezca al paquete actual.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Si falló la llamada relacionada con la migración de DPC. El mensaje y el subtipo de la excepción contienen más detalles sobre el error.