DpcMigrationClient

Kotlin |Java

interface DpcMigrationClient

---

İstemcinin, dpc taşımayla ilgili isteklerde bulunacak.

Özet

Genel işlevler
ListenableFuture<DpcMigrationAttempt?>	getMigrationAttempt(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) Taşıma denemesi yapılır.
suspend DpcMigrationAttempt?	getMigrationAttemptAwait(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) Taşıma denemesi yapılır.
ListenableFuture<List<DpcMigrationAttempt>>	listMigrationAttempts() Tüm taşıma denemelerinin listesini döndürür.
suspend List<DpcMigrationAttempt>	listMigrationAttemptsAwait() Tüm taşıma denemelerinin listesini döndürür.
ListenableFuture<DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) Bu cihazı Android Management API tarafından yönetilecek yere taşıyın.
suspend DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) Bu cihazı Android Management API tarafından yönetilecek yere taşıyın.

Genel işlevler

getMigrationAttempt

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

Taşıma denemesi yapılır.

GetDpcMigrationAttemptRequest içinde herhangi bir ad belirtilmezse en son DpcMigrationAttempt döndürülür.

Bu yöntem yalnızca Android Management API'ye taşınmış bir Cihaz Sahibi veya Profil Sahibi ya da önceki bir Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir.

İlerlemeler

ListenableFuture<DpcMigrationAttempt?>

Sonucu sarmalayan bir ListenableFuture. Bu, şunlardan biri olabilir: Başarılı olmak koşuluyla, başarılı bir gelecek DpcMigrationAttempt sarmalaması. DpcMigrationAttempt bulunmaması durumunda, başarılı bir gelecek sarmalama boş değeri. Arayanın Cihaz Sahibi veya Profil Sahibi olmaması ya da Android Management API'ye taşınmış eski bir Cihaz Sahibi veya Profil Sahibi olmaması halinde gelecekte SecurityException sarmalanması başarısız oldu. Gelecekteki sarmalama başarısız DpcMigrationException Dpc taşımayla ilgili çağrı başarısız olduysa. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.

getMigrationAttemptAwait

suspend fun getMigrationAttemptAwait(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
): DpcMigrationAttempt?

Taşıma denemesi yapılır.

GetDpcMigrationAttemptRequest içinde herhangi bir ad belirtilmezse en son DpcMigrationAttempt döndürülür.

Bu yöntem yalnızca Android Management API'ye taşınmış bir Cihaz Sahibi veya Profil Sahibi ya da önceki bir Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir.

İlerlemeler
DpcMigrationAttempt?	İstenen DpcMigrationAttempt veya bulunamazsa null

Dekoratif yastıklar
java.lang.SecurityException	Arayan kişi bir Cihaz Sahibi veya Profil Sahibi değilse ya da Android Management API'ye taşınmış eski bir Cihaz Sahibi veya Profil Sahibi değilse.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Dpc taşımayla ilgili arama başarısız olduysa. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.

listMigrationAttempts

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

Tüm taşıma denemelerinin listesini döndürür.

Bu yöntem yalnızca Android Management API'ye taşınmış bir Cihaz Sahibi veya Profil Sahibi ya da önceki bir Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir. Not: Eski taşıma denemeleri otomatik olarak silinir ve geri getirilmez.

İlerlemeler

ListenableFuture<List<DpcMigrationAttempt>>

Sonucu sarmalayan bir ListenableFuture. Bu, şunlardan biri olabilir: Başarılı bir şekilde sonuçlanması halinde DpcMigrationAttempt listesini sarmalayan başarılı bir gelecek. Arayanın Cihaz Sahibi veya Profil Sahibi olmaması ya da Android Management API'ye taşınmış eski bir Cihaz Sahibi veya Profil Sahibi olmaması halinde gelecekte SecurityException sarmalanması başarısız oldu. Gelecekteki sarmalama başarısız DpcMigrationException Dpc taşımayla ilgili çağrı başarısız olduysa. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.

listMigrationAttemptsAwait

suspend fun listMigrationAttemptsAwait(): List<DpcMigrationAttempt>

Tüm taşıma denemelerinin listesini döndürür.

Bu yöntem yalnızca Android Management API'ye taşınmış bir Cihaz Sahibi veya Profil Sahibi ya da önceki bir Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir. Not: Eski taşıma denemeleri otomatik olarak silinir ve geri getirilmez.

İlerlemeler
List<DpcMigrationAttempt>	DpcMigrationAttempt listesi

Dekoratif yastıklar
java.lang.SecurityException	Arayan kişi bir Cihaz Sahibi veya Profil Sahibi değilse ya da Android Management API'ye taşınmış eski bir Cihaz Sahibi veya Profil Sahibi değilse.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Dpc taşımayla ilgili arama başarısız olduysa. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.

migrateDeviceManagementToAndroidManagementApi

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

Bu cihazı Android Management API tarafından yönetilecek yere taşıyın.

Taşıma işlemi tamamlandıktan sonra, arama uygulaması Android Device Policy'ye aktarıldığı için Cihaz Sahibi veya Profil Sahibi ayrıcalıklarını kaybeder.

Uyarı: Bu işlem geri alınamaz. Döndürülen ListenableFuture, Android Device Policy isteği alıp taşıma jetonuyla ilgili ön kontrolleri tamamladığında tamamlanır. Hata durumunda ListenableFuture bir Exception öğesini sarmalar.

Bu yöntem yalnızca Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir. Android 10 ve önceki sürümlerde bu çağrı, hem cihaz sahibi hem de profil sahibi olan cihazlarda çağrılmamalıdır.

Kişiye ait bir cihazda, yapılandırılmış kablosuz ağların DpcMigrationRequest uygulamasında Profil Sahibi tarafından (Android 12 hariç) iletilmesi gerekir (cihazda kablosuz ağ yapılandırıldıysa). Bu kimlikler şirkete ait cihazlarda verilmemelidir. Bu kablosuz ağların, cihaz yönetimi Android Device Policy'ye taşınmasından hemen önce kaldırılacağını unutmayın. Bir ağın kaldırılamaması durumunda taşıma işlemi de başarısız olur. Ağların kaldırılması atomik bir işlem olmadığından bazı ağlar zaten kaldırılmış olabilir.

Android 12 çalıştıran bir iş profiline sahip şahsa ait cihazlarda, migrationRequest ürününde iletilen kablosuz ağlardan bağımsız olarak, çağrı yapan DPC tarafından yapılandırılan tüm kablosuz ağlar cihaz yönetiminin Android Device Policy'ye taşınmasından hemen önce kaldırılır.

Parametreler
notificationServiceComponentName: ComponentName	NotificationReceiverService süresini kapsayan hizmetin ComponentName. Bu, çağrı uygulamasına ait olan ve manifest dosyasında dışa aktarılan geçerli bir bileşen olmalıdır. Aksi takdirde bir IllegalArgumentException yayınlanır.
adminComponentName: ComponentName	Arayan DPC'nin ComponentName yöneticisinin DeviceAdminReceiver.
migrationRequest: DpcMigrationRequest	Taşıma jetonunu ve yapılandırılmış kablosuz ağları içeren DpcMigrationRequest. İkinci yöntem yalnızca, arayan kişi kendisine ait bir cihazda Profil Sahibi ise ve herhangi bir ağı yapılandırmışsa gereklidir.

İlerlemeler

ListenableFuture<DpcMigrationAttempt>

Sonucu sarmalayan bir ListenableFuture. Bu, şunlardan biri olabilir: Başarılı olmak koşuluyla, başarılı bir gelecek DpcMigrationAttempt sarmalaması. Arayan cihaz Sahibi veya Profil Sahibi değilse SecurityException için sarmalama yapılamadı. Taşıma jetonu boşsa, notificationServiceComponentName, manifest'te dışa aktarılan NotificationReceiverService öğesini genişleten geçerli bir bileşene işaret etmiyorsa ya da adminComponentName, geçerli pakete ait etkin bir yönetici değilse IllegalArgumentException gelecekteki sarmalama başarısız oldu. dpc taşımayla ilgili çağrı başarısız olduysa DpcMigrationException gelecekteki sarmalama başarısız oldu. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.

migrateDeviceManagementToAndroidManagementApiAwait

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

Bu cihazı Android Management API tarafından yönetilecek yere taşıyın.

Taşıma işlemi tamamlandıktan sonra, arama uygulaması Android Device Policy'ye aktarıldığı için Cihaz Sahibi veya Profil Sahibi ayrıcalıklarını kaybeder.

Uyarı: Bu işlem geri alınamaz. Bu askıya alma eğlencesi, Android Device Policy isteği alıp taşıma jetonuyla ilgili ön kontrolleri tamamladığında geri gelir. Başarısızlık durumunda bir Exception atılır.

Bu yöntem yalnızca Cihaz Sahibi veya Profil Sahibi tarafından çağrılabilir. Android 10 ve önceki sürümlerde bu çağrı, hem cihaz sahibi hem de profil sahibi olan cihazlarda çağrılmamalıdır.

Kişiye ait bir cihazda, yapılandırılmış kablosuz ağların DpcMigrationRequest uygulamasında Profil Sahibi tarafından (Android 12 hariç) iletilmesi gerekir (cihazda kablosuz ağ yapılandırıldıysa). Bu kimlikler şirkete ait cihazlarda verilmemelidir. Bu kablosuz ağların, cihaz yönetimi Android Device Policy'ye taşınmasından hemen önce kaldırılacağını unutmayın. Bir ağın kaldırılamaması durumunda taşıma işlemi de başarısız olur. Ağların kaldırılması atomik bir işlem olmadığından bazı ağlar zaten kaldırılmış olabilir.

Android 12 çalıştıran bir iş profiline sahip şahsa ait cihazlarda, migrationRequest ürününde iletilen kablosuz ağlardan bağımsız olarak, çağrı yapan DPC tarafından yapılandırılan tüm kablosuz ağlar cihaz yönetiminin Android Device Policy'ye taşınmasından hemen önce kaldırılır.

Parametreler
notificationServiceComponentName: ComponentName	NotificationReceiverService süresini kapsayan hizmetin ComponentName. Bu, çağrı uygulamasına ait olan ve manifest dosyasında dışa aktarılan geçerli bir bileşen olmalıdır. Aksi takdirde bir IllegalArgumentException yayınlanır.
adminComponentName: ComponentName	Arayan DPC'nin ComponentName yöneticisinin DeviceAdminReceiver.
migrationRequest: DpcMigrationRequest	Taşıma jetonunu ve yapılandırılmış kablosuz ağları içeren DpcMigrationRequest. İkinci yöntem yalnızca, arayan kişi kendisine ait bir cihazda Profil Sahibi ise ve herhangi bir ağı yapılandırmışsa gereklidir.

İlerlemeler
DpcMigrationAttempt	Başarılı olması durumunda taşımanın mevcut durumuyla birlikte DpcMigrationException.

Dekoratif yastıklar
java.lang.SecurityException	Arayan kişi bir Cihaz Sahibi veya Profil Sahibi değilse.
java.lang.IllegalArgumentException	Taşıma jetonu boşsa veya notificationServiceComponentName, manifestte dışa aktarılan NotificationReceiverService öğesini genişleten geçerli bir bileşene işaret etmiyorsa ya da adminComponentName, geçerli pakete ait etkin bir yönetici değilse.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Dpc taşımayla ilgili arama başarısız olduysa. İleti ve istisnanın alt türü, hatayla ilgili daha fazla ayrıntı içerir.