EnvironmentClient

Si los roles solicitados no son válidos

Si la llamada falló debido a un error interno.

Si el nivel de API del SDK del dispositivo no es suficiente para ciertos roles solicitados (esto puede ser adicional a un requisito general de nivel de API mínimo para la llamada en sí) {@code Role.RoleType.DEVICE_POLICY_CONTROLLER} requiere el nivel de API 23 o superior. Cualquier otro rol requiere el nivel de API 28 o superior.

Un ListenableFuture que contiene el resultado. Puede ser:

• Es un futuro exitoso que contiene un Environment en caso de éxito.

• Es un futuro con errores que encapsula un InvalidArgumentException si los roles solicitados no son válidos.

• Es un futuro fallido que contiene un InternalException si la llamada falló debido a un error interno.

Si el nivel de API del SDK del dispositivo no es suficiente para ciertos roles solicitados (esto puede ser adicional a un requisito general de nivel de API mínimo para la llamada en sí) {@code Role.RoleType.DEVICE_POLICY_CONTROLLER} requiere el nivel de API 23 o superior. Cualquier otro rol requiere el nivel de API 28 o superior.

Es el ComponentName del servicio que extiende NotificationReceiverService. Si se proporciona, debe ser un componente válido que pertenezca a la app que realiza la llamada y que se haya exportado en el manifiesto. Para recibir notificaciones sobre los eventos de preparación del entorno, debes hacer lo siguiente:

1. Implementa la interfaz EnvironmentListener en tu app.

2. Proporciona una implementación para controlar los eventos recibidos.

3. Extiende NotificationReceiverService y proporciona una instancia de EnvironmentListener.

4. Agrega la clase NotificationReceiverService extendida a tu archivo AndroidManifest.xml y asegúrate de que se exporte.

Por ejemplo:

class MyEnvironmentListener : EnvironmentListener {
  override fun onEnvironmentEvent(event: EnvironmentEvent) {
    // Handle the environment event.
  }
}

class MyNotificationReceiverService : NotificationReceiverService() {
  override fun getPrepareEnvironmentListener(): EnvironmentListener? {
    return MyEnvironmentListener()
  }
}

PrepareEnvironmentResponse que contiene detalles sobre el estado final de la preparación del entorno.

Si:

• [notificationServiceComponentName] no es un componente válido que pertenece a la app que realiza la llamada o no se exportó en el manifiesto.
• Los roles solicitados incluyen {@code Role.RoleType.DEVICE_POLICY_CONTROLLER}, y no se proporciona {@code com.google.android.managementapi.environment.model.PrepareEnvironmentRequest.admin} o no extiende {@code android.app.admin.DeviceAdminReceiver}.
• Los roles solicitados no son válidos.

Si el llamador no está autorizado para llamar a esta API.

Si los Servicios de Google Play no están actualizados

Si la Política de dispositivos Android no se puede instalar o actualizar, y el error es irrecuperable.

Si la app de Política de dispositivos Android no se instala o actualiza, y el error se puede recuperar (p.ej., la solicitud falló debido a problemas de red transitorios), se puede volver a intentar la solicitud.

Si el usuario rechaza la instalación de la app de Android Device Policy

Si el usuario descarta la pantalla de consentimiento de instalación.

Si la llamada falló debido a un error interno.

Si falló la actualización de Play Store.

Si el nivel de API del SDK del dispositivo no es suficiente para ciertos roles solicitados (esto puede ser adicional a un requisito general de nivel de API mínimo para la llamada en sí).{@code Role.RoleType.DEVICE_POLICY_CONTROLLER} requiere el nivel de API 23 o superior. Cualquier otro rol requiere el nivel de API 28 o superior.

Es el ComponentName del servicio que extiende NotificationReceiverService. Si se proporciona, debe ser un componente válido que pertenezca a la app que realiza la llamada y que se haya exportado en el manifiesto. Para recibir notificaciones sobre los eventos de preparación del entorno, debes hacer lo siguiente:

1. Implementa la interfaz EnvironmentListener en tu app.

2. Proporciona una implementación para controlar los eventos recibidos.

3. Extiende NotificationReceiverService y proporciona una instancia de EnvironmentListener.

4. Agrega la clase NotificationReceiverService extendida a tu archivo AndroidManifest.xml y asegúrate de que se exporte.

Por ejemplo:

class MyEnvironmentListener : EnvironmentListener {
  override fun onEnvironmentEvent(event: EnvironmentEvent) {
    // Handle the environment event.
  }
}

class MyNotificationReceiverService : NotificationReceiverService() {
  override fun getPrepareEnvironmentListener(): EnvironmentListener? {
    return MyEnvironmentListener()
  }
}

Un ListenableFuture que contiene el resultado. Puede ser

• Es un futuro exitoso que encapsula un PrepareEnvironmentResponse que contiene detalles sobre el estado final de la preparación del entorno.

• Un futuro fallido que contiene un InvalidArgumentException si se cumple alguna de las siguientes condiciones:

  • [notificationServiceComponentName] no es un componente válido que pertenece a la app que realiza la llamada o no se exportó en el manifiesto.
  • Los roles solicitados no son válidos.
  • Los roles solicitados incluyen {@code Role.RoleType.DEVICE_POLICY_CONTROLLER}, y no se proporciona {@code com.google.android.managementapi.environment.model.PrepareEnvironmentRequest.admin} o no extiende {@code android.app.admin.DeviceAdminReceiver}.

• Es un futuro fallido que contiene un SecurityException si el llamador no está autorizado para llamar a esta API.

• Es un futuro fallido que contiene un objeto GooglePlayServicesAppNotUpdatedException si los Servicios de Google Play no están actualizados.

• Es un futuro con errores que contiene un AndroidDevicePolicyInstallOrUpdateUnrecoverableException si no se puede instalar o actualizar Android Device Policy y el error es irrecuperable.

• Es un futuro fallido que encapsula un AndroidDevicePolicyInstallOrUpdateRecoverableException si falla la instalación o actualización de la app de Android Device Policy y el error es recuperable (p.ej., la solicitud falló debido a problemas de red transitorios), por lo que se puede volver a intentar la solicitud.

• Es un futuro con errores que encapsula un AndroidDevicePolicyInstallConsentDeclinedException si el usuario rechaza la instalación de la app de Android Device Policy.

• Es un futuro fallido que encapsula un AndroidDevicePolicyInstallConsentDismissedException si el usuario descarta la pantalla de consentimiento de instalación.

• Es un futuro fallido que contiene un InternalException si la llamada falló debido a un error interno.

• Es un futuro fallido que encapsula un PlayStoreUpdateUnrecoverableException si falló la actualización de Play Store.

Si el nivel de API del SDK del dispositivo no es suficiente para ciertos roles solicitados {@code Role.RoleType.DEVICE_POLICY_CONTROLLER} requiere el nivel de API 23 o superior. Cualquier otro rol requiere el nivel de API 28 o superior.