EnvironmentClient

Public functions
`suspend Environment`	`@RequiresApi(value = 28) getEnvironment(request: GetEnvironmentRequest)` Returns the `Environment`.
`ListenableFuture<Environment>`	`@RequiresApi(value = 28) getEnvironmentAsync(request: GetEnvironmentRequest)` Returns the `Environment`.
`suspend PrepareEnvironmentResponse`	`@RequiresApi(value = 28) prepareEnvironment( request: PrepareEnvironmentRequest, notificationServiceComponentName: ComponentName? )` Prepares the device environment.
`ListenableFuture<PrepareEnvironmentResponse>`	`@RequiresApi(value = 28) prepareEnvironmentAsync( request: PrepareEnvironmentRequest, notificationServiceComponentName: ComponentName? )` Prepares the device environment.

getEnvironment

@RequiresApi(value = 28)
suspend fun getEnvironment(request: GetEnvironmentRequest): Environment

Returns the Environment. It helps the caller to know if environment is ready or not.

Throws
`java.lang.SecurityException`	If the caller is not authorized to call this API.
`com.google.android.managementapi.common.exceptions.ApiLevelException`	If the device API level is less than 28.
`com.google.android.managementapi.common.exceptions.InvalidArgumentException`	If the requested roles are not valid.
`com.google.android.managementapi.common.exceptions.InternalException`	If call failed due to an internal error.

getEnvironmentAsync

@RequiresApi(value = 28)
fun getEnvironmentAsync(request: GetEnvironmentRequest): ListenableFuture<Environment>

Returns the Environment. It helps the caller to know if environment is ready or not.

Returns

Returns
`ListenableFuture<Environment>`	A `ListenableFuture` wrapping the result. This can be: A successful future wrapping a `Environment`, in case of success. A failed future wrapping a `SecurityException`, if the caller is not authorized to call this API. A failed future wrapping a `ApiLevelException`, if the device API level is less than 28. A failed future wrapping a `InvalidArgumentException`, if the requested roles are not valid. A failed future wrapping a `InternalException`, if call failed due to an internal error.

ListenableFuture<Environment>

A ListenableFuture wrapping the result. This can be:

A successful future wrapping a Environment, in case of success.
A failed future wrapping a SecurityException, if the caller is not authorized to call this API.
A failed future wrapping a ApiLevelException, if the device API level is less than 28.
A failed future wrapping a InvalidArgumentException, if the requested roles are not valid.
A failed future wrapping a InternalException, if call failed due to an internal error.

prepareEnvironment

@RequiresApi(value = 28)
suspend fun prepareEnvironment(
    request: PrepareEnvironmentRequest,
    notificationServiceComponentName: ComponentName?
): PrepareEnvironmentResponse

Prepares the device environment.

Prompts the user to install the necessary Android Device Policy application. Proceeds with installation if user accepts the prompt. After successful installation, it performs operations to make sure that the Android Device Policy app is ready.

Parameters

Parameters
`notificationServiceComponentName: ComponentName?`	The `ComponentName` of the service extending `NotificationReceiverService`. If provided, it must be a valid component belonging to the calling app, and exported in the manifest. To get notified of Environment preparation events, you need to: Implement the `EnvironmentListener` interface in your app. Provide an implementation for how to handle the received events. Extend NotificationReceiverService and provide an `EnvironmentListener` instance. Add the extended NotificationReceiverService class to your AndroidManifest.xml and ensure that it is exported. For example: class MyEnvironmentListener : EnvironmentListener { override fun onEnvironmentEvent(event: EnvironmentEvent) { // Handle the environment event. } } class MyNotificationReceiverService : NotificationReceiverService() { override fun getPrepareEnvironmentListener(): EnvironmentListener? { return MyEnvironmentListener() } }

notificationServiceComponentName: ComponentName?

The ComponentName of the service extending NotificationReceiverService. If provided, it must be a valid component belonging to the calling app, and exported in the manifest. To get notified of Environment preparation events, you need to:

Implement the EnvironmentListener interface in your app.
Provide an implementation for how to handle the received events.
Extend NotificationReceiverService and provide an EnvironmentListener instance.
Add the extended NotificationReceiverService class to your AndroidManifest.xml and ensure that it is exported.

For example:

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

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

Returns
`PrepareEnvironmentResponse`	`PrepareEnvironmentResponse` containing details about the final status of the environment preparation.

Throws
`com.google.android.managementapi.common.exceptions.InvalidArgumentException`	If: [notificationServiceComponentName] is not a valid component belonging to the calling app or not exported in the manifest. The requested roles are not valid.
`com.google.android.managementapi.common.exceptions.ApiLevelException`	If the device API level is less than 28.
`java.lang.SecurityException`	If the caller is not authorized to call this API.
`com.google.android.managementapi.common.exceptions.GooglePlayServicesAppNotUpdatedException`	If Google Play Services is not up-to-date.
`com.google.android.managementapi.environment.exceptions.AndroidDevicePolicyInstallOrUpdateUnrecoverableException`	If Android Device Policy app fails to install or update and the error is unrecoverable.
`com.google.android.managementapi.environment.exceptions.AndroidDevicePolicyInstallOrUpdateRecoverableException`	If Android Device Policy app fails to install or update and the error is recoverable (e.g. request failed due to transient network issues), so the request can be retried.
`com.google.android.managementapi.environment.exception.AndroidDevicePolicyInstallConsentDeclinedException`	If the user declines to install Android Device Policy app.
`com.google.android.managementapi.environment.exception.AndroidDevicePolicyInstallConsentDismissedException`	If the user dismisses the installation consent screen.
`com.google.android.managementapi.common.exceptions.InternalException`	If call failed due to an internal error.

prepareEnvironmentAsync

@RequiresApi(value = 28)
fun prepareEnvironmentAsync(
    request: PrepareEnvironmentRequest,
    notificationServiceComponentName: ComponentName?
): ListenableFuture<PrepareEnvironmentResponse>

Prepares the device environment.

Prompts the user to install the necessary Android Device Policy application. Proceeds with installation if user accepts the prompt. After successful installation, it performs operations to make sure that the Android Device Policy app is ready.

Parameters

Parameters
`notificationServiceComponentName: ComponentName?`	The `ComponentName` of the service extending `NotificationReceiverService`. If provided, it must be a valid component belonging to the calling app, and exported in the manifest. To get notified of environment preparation events, you need to: Implement the `EnvironmentListener` interface in your app. Provide an implementation for how to handle the received events. Extend NotificationReceiverService and provide an `EnvironmentListener` instance. Add the extended NotificationReceiverService class to your AndroidManifest.xml and ensure that it is exported. For example: class MyEnvironmentListener : EnvironmentListener { override fun onEnvironmentEvent(event: EnvironmentEvent) { // Handle the environment event. } } class MyNotificationReceiverService : NotificationReceiverService() { override fun getPrepareEnvironmentListener(): EnvironmentListener? { return MyEnvironmentListener() } }

notificationServiceComponentName: ComponentName?

The ComponentName of the service extending NotificationReceiverService. If provided, it must be a valid component belonging to the calling app, and exported in the manifest. To get notified of environment preparation events, you need to:

Implement the EnvironmentListener interface in your app.
Provide an implementation for how to handle the received events.
Extend NotificationReceiverService and provide an EnvironmentListener instance.
Add the extended NotificationReceiverService class to your AndroidManifest.xml and ensure that it is exported.

For example:

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

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

Returns

Returns
`ListenableFuture<PrepareEnvironmentResponse>`	A `ListenableFuture` wrapping the result. This can be A successful future wrapping a `PrepareEnvironmentResponse` containing details about the final status of the environment preparation. A failed future wrapping a `InvalidArgumentException` if: [notificationServiceComponentName] is not a valid component belonging to the calling app or not exported in the manifest. The requested roles are not valid. A failed future wrapping a `ApiLevelException` if the device API level is less than 28. A failed future wrapping a `SecurityException`, if the caller is not authorized to call this API. A failed future wrapping a `GooglePlayServicesAppNotUpdatedException` if Google Play Services is not up-to-date. A failed future wrapping a `AndroidDevicePolicyInstallOrUpdateUnrecoverableException` if Android Device Policy fails to install or update and the error is unrecoverable. A failed future wrapping a `AndroidDevicePolicyInstallOrUpdateRecoverableException` if Android Device Policy app fails to install or update and the error is recoverable (e.g. request failed due to transient network issues), so the request can be retried. A failed future wrapping a `AndroidDevicePolicyInstallConsentDeclinedException` if the user declines to install Android Device Policy app. A failed future wrapping a `AndroidDevicePolicyInstallConsentDismissedException` if the user dismisses the installation consent screen. A failed future wrapping a `InternalException`, if call failed due to an internal error.

ListenableFuture<PrepareEnvironmentResponse>

A ListenableFuture wrapping the result. This can be

A successful future wrapping a PrepareEnvironmentResponse containing details about the final status of the environment preparation.
A failed future wrapping a InvalidArgumentException if:
- [notificationServiceComponentName] is not a valid component belonging to the calling app or not exported in the manifest.
- The requested roles are not valid.
A failed future wrapping a ApiLevelException if the device API level is less than 28.
A failed future wrapping a SecurityException, if the caller is not authorized to call this API.
A failed future wrapping a GooglePlayServicesAppNotUpdatedException if Google Play Services is not up-to-date.
A failed future wrapping a AndroidDevicePolicyInstallOrUpdateUnrecoverableException if Android Device Policy fails to install or update and the error is unrecoverable.
A failed future wrapping a AndroidDevicePolicyInstallOrUpdateRecoverableException if Android Device Policy app fails to install or update and the error is recoverable (e.g. request failed due to transient network issues), so the request can be retried.
A failed future wrapping a AndroidDevicePolicyInstallConsentDeclinedException if the user declines to install Android Device Policy app.
A failed future wrapping a AndroidDevicePolicyInstallConsentDismissedException if the user dismisses the installation consent screen.
A failed future wrapping a InternalException, if call failed due to an internal error.

Summary

Public functions

Public functions

getEnvironment

getEnvironmentAsync

prepareEnvironment

prepareEnvironmentAsync