DpcMigrationClient
public interface DpcMigrationClient
DPC 移行関連のリクエストを行うクライアント。
概要
パブリック メソッド
getMigrationAttempt
abstract @NonNull ListenableFuture<DpcMigrationAttempt> getMigrationAttempt(
@NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)
移行の試行を取得します。
GetDpcMigrationAttemptRequest に名前が指定されていない場合は、最新の DpcMigrationAttempt が返されます。
このメソッドは、デバイス所有者またはプロファイル所有者、または Android Management API に移行した以前のデバイス所有者またはプロファイル所有者のみが呼び出すことができます。
| 戻り値 | |
|---|---|
@NonNull ListenableFuture<DpcMigrationAttempt> |
結果をラップする
|
getMigrationAttemptAwait
abstract DpcMigrationAttempt getMigrationAttemptAwait(
@NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)
移行の試行を取得します。
GetDpcMigrationAttemptRequest に名前が指定されていない場合は、最新の DpcMigrationAttempt が返されます。
このメソッドは、デバイス所有者またはプロファイル所有者、または Android Management API に移行した以前のデバイス所有者またはプロファイル所有者のみが呼び出すことができます。
| 戻り値 | |
|---|---|
DpcMigrationAttempt |
リクエストされた |
| 例外 | |
|---|---|
java.lang.SecurityException |
呼び出し元がデバイス所有者でもプロファイル所有者でもない場合、または Android Management API に移行した以前のデバイス所有者またはプロファイル所有者の場合。 |
com.google.android.managementapi.dpcmigration.DpcMigrationException |
dpc の移行に関連する呼び出しが失敗した場合。メッセージと例外のサブタイプに、失敗に関する詳細情報が含まれています。 |
listMigrationAttempts
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> listMigrationAttempts()
すべての移行の試行のリストを返します。
このメソッドは、デバイス所有者またはプロファイル所有者、または Android Management API に移行した以前のデバイス所有者またはプロファイル所有者のみが呼び出すことができます。注: 以前の移行試行は自動的に削除され、返されません。
| 戻り値 | |
|---|---|
@NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> |
結果をラップする
|
listMigrationAttemptsAwait
abstract @NonNull List<@NonNull DpcMigrationAttempt> listMigrationAttemptsAwait()
すべての移行の試行のリストを返します。
このメソッドは、デバイス所有者またはプロファイル所有者、または Android Management API に移行した以前のデバイス所有者またはプロファイル所有者のみが呼び出すことができます。注: 以前の移行試行は自動的に削除され、返されません。
| 戻り値 | |
|---|---|
@NonNull List<@NonNull DpcMigrationAttempt> |
|
| 例外 | |
|---|---|
java.lang.SecurityException |
呼び出し元がデバイス所有者でもプロファイル所有者でもない場合、または Android Management API に移行した以前のデバイス所有者またはプロファイル所有者の場合。 |
com.google.android.managementapi.dpcmigration.DpcMigrationException |
dpc の移行に関連する呼び出しが失敗した場合。メッセージと例外のサブタイプに、失敗に関する詳細情報が含まれています。 |
migrateDeviceManagementToAndroidManagementApi
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt> migrateDeviceManagementToAndroidManagementApi(
@NonNull ComponentName notificationServiceComponentName,
@NonNull ComponentName adminComponentName,
@NonNull DpcMigrationRequest migrationRequest
)
このデバイスを Android Management API の管理対象に移行します。
移行が完了すると、呼び出し元アプリは、デバイス所有者やプロファイル所有者の権限が Android Device Policy に移行されるため、権限を失います。
警告: この操作は元に戻せません。Android Device Policy がリクエストを受信し、移行トークンの予備チェックが完了すると、返された ListenableFuture が完了します。失敗した場合、ListenableFuture は Exception をラップします。
このメソッドは、デバイス所有者またはプロファイル所有者のみが呼び出すことができます。Android 10 以前では、デバイス所有者とプロファイル所有者の両方が登録されているデバイスでは、これを呼び出すことはできません。
個人所有デバイスで Wi-Fi ネットワークが設定されている場合、設定済みの Wi-Fi ネットワークは、プロファイル所有者が DpcMigrationRequest で渡す必要があります（Android 12 を除く）。会社所有のデバイスでは渡さないでください。これらの Wi-Fi ネットワークは、デバイス管理が Android Device Policy に移行される直前に削除されます。ネットワークの削除に失敗した場合、移行も失敗します。ネットワークの削除はアトミック オペレーションではないため、一部のネットワークはすでに削除されている可能性があります。
Android 12 を搭載した仕事用プロファイルが設定された個人所有デバイスでは、migrationRequest で渡された Wi-Fi ネットワークに関係なく、デバイス管理が Android Device Policy に移行される直前に、呼び出し元の DPC によって設定されたすべての Wi-Fi ネットワークが削除されます。
| パラメータ | |
|---|---|
@NonNull ComponentName notificationServiceComponentName |
|
@NonNull ComponentName adminComponentName |
呼び出し元 DPC の管理者 |
@NonNull DpcMigrationRequest migrationRequest |
移行トークンと設定済みの Wi-Fi ネットワークを含む |
| 戻り値 | |
|---|---|
@NonNull ListenableFuture<@NonNull DpcMigrationAttempt> |
結果をラップする
|
migrateDeviceManagementToAndroidManagementApiAwait
abstract @NonNull DpcMigrationAttempt migrateDeviceManagementToAndroidManagementApiAwait(
@NonNull ComponentName notificationServiceComponentName,
@NonNull ComponentName adminComponentName,
@NonNull DpcMigrationRequest migrationRequest
)
このデバイスを Android Management API の管理対象に移行します。
移行が完了すると、呼び出し元アプリは、デバイス所有者やプロファイル所有者の権限が Android Device Policy に移行されるため、権限を失います。
警告: この操作は元に戻せません。この suspend fun は、Android Device Policy がリクエストを受信し、移行トークンの予備チェックを完了したときに返されます。失敗した場合は、Exception がスローされます。
このメソッドは、デバイス所有者またはプロファイル所有者のみが呼び出すことができます。Android 10 以前では、デバイス所有者とプロファイル所有者の両方が登録されているデバイスでは、これを呼び出すことはできません。
個人所有デバイスで Wi-Fi ネットワークが設定されている場合、設定済みの Wi-Fi ネットワークは、プロファイル所有者が DpcMigrationRequest で渡す必要があります（Android 12 を除く）。会社所有のデバイスでは渡さないでください。これらの Wi-Fi ネットワークは、デバイス管理が Android Device Policy に移行される直前に削除されます。ネットワークの削除に失敗した場合、移行も失敗します。ネットワークの削除はアトミック オペレーションではないため、一部のネットワークはすでに削除されている可能性があります。
Android 12 を搭載した仕事用プロファイルが設定された個人所有デバイスでは、migrationRequest で渡された Wi-Fi ネットワークに関係なく、デバイス管理が Android Device Policy に移行される直前に、呼び出し元の DPC によって設定されたすべての Wi-Fi ネットワークが削除されます。
| パラメータ | |
|---|---|
@NonNull ComponentName notificationServiceComponentName |
|
@NonNull ComponentName adminComponentName |
呼び出し元 DPC の管理者 |
@NonNull DpcMigrationRequest migrationRequest |
移行トークンと設定済みの Wi-Fi ネットワークを含む |
| 戻り値 | |
|---|---|
@NonNull DpcMigrationAttempt |
|
| 例外 | |
|---|---|
java.lang.SecurityException |
発信者がデバイス所有者でもプロファイル所有者でもない場合。 |
java.lang.IllegalArgumentException |
移行トークンが空の場合、またはマニフェストでエクスポートされる |
com.google.android.managementapi.dpcmigration.DpcMigrationException |
dpc の移行に関連する呼び出しが失敗した場合。メッセージと例外のサブタイプに、失敗に関する詳細情報が含まれています。 |