DpcMigrationClient

Kotlin |Java

interface DpcMigrationClient

---

ไคลเอ็นต์ที่จะสร้างคำขอที่เกี่ยวข้องกับการย้ายข้อมูล dpc

สรุป

ฟังก์ชันสาธารณะ
ListenableFuture<DpcMigrationAttempt?>	getMigrationAttempt(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) รับความพยายามในการย้ายข้อมูล
suspend DpcMigrationAttempt?	getMigrationAttemptAwait(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) รับความพยายามในการย้ายข้อมูล
ListenableFuture<List<DpcMigrationAttempt>>	listMigrationAttempts() แสดงรายการการพยายามย้ายข้อมูลทั้งหมด
suspend List<DpcMigrationAttempt>	listMigrationAttemptsAwait() แสดงรายการการพยายามย้ายข้อมูลทั้งหมด
ListenableFuture<DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) ย้ายข้อมูลอุปกรณ์นี้เพื่อรับการจัดการโดย Android Management API
suspend DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) ย้ายข้อมูลอุปกรณ์นี้เพื่อรับการจัดการโดย Android Management API

ฟังก์ชันสาธารณะ

getMigrationAttempt

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

รับความพยายามในการย้ายข้อมูล

หากไม่ได้ระบุชื่อใน GetDpcMigrationAttemptRequest ระบบจะแสดงผล DpcMigrationAttempt ล่าสุด

มีเพียงเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ หรือเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์คนก่อนหน้าที่ย้ายข้อมูลไปยัง Android Management API เท่านั้นที่จะเรียกใช้วิธีการนี้ได้

การคืนสินค้า

ListenableFuture<DpcMigrationAttempt?>

ListenableFuture ที่รวมผลลัพธ์ ประเภทรายการได้แก่ การห่อ DpcMigrationAttempt ที่ประสบความสำเร็จในอนาคตในกรณีที่ประสบความสำเร็จ การตัดค่า Null ในอนาคตให้สำเร็จในกรณีที่ไม่พบ DpcMigrationAttempt ความล้มเหลวในการรวม SecurityException ในกรณีที่ผู้โทรไม่ได้เป็นเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ หรือเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์คนก่อนหน้าซึ่งย้ายข้อมูลไปยัง Android Management API การรวม DpcMigrationException ในอนาคตที่ล้มเหลว หากการเรียกใช้ที่เกี่ยวข้องกับการย้ายข้อมูล dpc ล้มเหลว ข้อความและประเภทย่อยของข้อยกเว้นมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว

getMigrationAttemptAwait

suspend fun getMigrationAttemptAwait(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
): DpcMigrationAttempt?

รับความพยายามในการย้ายข้อมูล

หากไม่ได้ระบุชื่อใน GetDpcMigrationAttemptRequest ระบบจะแสดงผล DpcMigrationAttempt ล่าสุด

มีเพียงเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ หรือเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์คนก่อนหน้าที่ย้ายข้อมูลไปยัง Android Management API เท่านั้นที่จะเรียกใช้วิธีการนี้ได้

การคืนสินค้า
DpcMigrationAttempt?	DpcMigrationAttempt หรือ Null ที่ขอ หากไม่พบ

การขว้าง
java.lang.SecurityException	หากผู้โทรไม่ใช่เจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ หรือเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์คนก่อนหน้าซึ่งย้ายข้อมูลไปยัง Android Management API
com.google.android.managementapi.dpcmigration.DpcMigrationException	หากการโทรที่เกี่ยวข้องกับการย้ายข้อมูล dpc ล้มเหลว ข้อความและประเภทย่อยของข้อยกเว้นมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว

listMigrationAttempts

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

แสดงรายการการพยายามย้ายข้อมูลทั้งหมด

มีเพียงเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ หรือเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์คนก่อนหน้าที่ย้ายข้อมูลไปยัง Android Management API เท่านั้นที่จะเรียกใช้วิธีการนี้ได้ หมายเหตุ: ความพยายามในการย้ายข้อมูลก่อนหน้านี้จะถูกลบโดยอัตโนมัติและไม่แสดงผล

การคืนสินค้า

ListenableFuture<List<DpcMigrationAttempt>>

ListenableFuture ที่รวมผลลัพธ์ ประเภทรายการได้แก่ การรวมรายการ DpcMigrationAttempt ไว้ในอนาคตจะประสบความสำเร็จในกรณีที่สำเร็จ ความล้มเหลวในการรวม SecurityException ในกรณีที่ผู้โทรไม่ได้เป็นเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ หรือเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์คนก่อนหน้าซึ่งย้ายข้อมูลไปยัง Android Management API การรวม DpcMigrationException ในอนาคตที่ล้มเหลว หากการเรียกใช้ที่เกี่ยวข้องกับการย้ายข้อมูล dpc ล้มเหลว ข้อความและประเภทย่อยของข้อยกเว้นมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว

listMigrationAttemptsAwait

suspend fun listMigrationAttemptsAwait(): List<DpcMigrationAttempt>

แสดงรายการการพยายามย้ายข้อมูลทั้งหมด

มีเพียงเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ หรือเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์คนก่อนหน้าที่ย้ายข้อมูลไปยัง Android Management API เท่านั้นที่จะเรียกใช้วิธีการนี้ได้ หมายเหตุ: ความพยายามในการย้ายข้อมูลก่อนหน้านี้จะถูกลบโดยอัตโนมัติและไม่แสดงผล

การคืนสินค้า
List<DpcMigrationAttempt>	ลิสต์ของ DpcMigrationAttempt

การขว้าง
java.lang.SecurityException	หากผู้โทรไม่ใช่เจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ หรือเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์คนก่อนหน้าซึ่งย้ายข้อมูลไปยัง Android Management API
com.google.android.managementapi.dpcmigration.DpcMigrationException	หากการโทรที่เกี่ยวข้องกับการย้ายข้อมูล dpc ล้มเหลว ข้อความและประเภทย่อยของข้อยกเว้นมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว

migrateDeviceManagementToAndroidManagementApi

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

ย้ายข้อมูลอุปกรณ์นี้เพื่อรับการจัดการโดย Android Management API

เมื่อย้ายข้อมูลเสร็จสมบูรณ์แล้ว แอปการโทรจะสูญเสียสิทธิ์เจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ เนื่องจากสิทธิ์เหล่านี้จะโอนไปยัง Android Device Policy

คำเตือน: การดำเนินการนี้เลิกทำไม่ได้ ListenableFuture ที่ส่งกลับมาจะเสร็จสมบูรณ์เมื่อ Android Device Policy ได้รับคำขอและการตรวจสอบเบื้องต้นเกี่ยวกับโทเค็นการย้ายข้อมูล ในกรณีที่ล้มเหลว ListenableFuture จะรวม Exception ไว้ด้วย

มีเพียงเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์เท่านั้นที่จะเรียกใช้วิธีการนี้ได้ ใน Android 10 และต่ำกว่า ต้องไม่เรียกใช้การตั้งค่านี้ในอุปกรณ์ที่มีทั้งเจ้าของอุปกรณ์และเจ้าของโปรไฟล์

เจ้าของโปรไฟล์ (ยกเว้นใน Android 12) จะต้องส่งเครือข่าย Wi-Fi ที่กำหนดค่าไว้ในอุปกรณ์ส่วนตัวหากได้กำหนดค่าเครือข่าย Wi-Fi ไว้ภายใน DpcMigrationRequest และจะต้องไม่ส่งข้อมูลเหล่านี้เข้ามาในอุปกรณ์ของบริษัท โปรดทราบว่าเราจะนำเครือข่าย Wi-Fi เหล่านี้ออกก่อนที่จะย้ายข้อมูลการจัดการอุปกรณ์ไปยัง Android Device Policy ในกรณีที่นำเครือข่ายออกไม่สำเร็จ การย้ายข้อมูลก็จะล้มเหลวด้วย และเนื่องจากการนำเครือข่ายออกไม่ใช่การดำเนินการแบบปรมาณู บางเครือข่ายจึงอาจถูกนำออกไปแล้ว

ในอุปกรณ์ส่วนตัวที่มีโปรไฟล์งานซึ่งใช้ Android 12 ระบบจะนำเครือข่าย Wi-Fi ทั้งหมดที่กำหนดค่าโดย DPC สำหรับการโทรออกก่อนที่จะย้ายข้อมูลการจัดการอุปกรณ์ไปยัง Android Device Policy ไม่ว่าเครือข่าย Wi-Fi ที่ส่งใน migrationRequest จะเป็นอย่างไรก็ตาม

พารามิเตอร์
notificationServiceComponentName: ComponentName	ComponentNameของบริการที่ขยาย NotificationReceiverService โดยต้องเป็นคอมโพเนนต์ที่ถูกต้องที่เป็นของแอปที่โทรและส่งออกในไฟล์ Manifest มิเช่นนั้น จะมีการส่ง IllegalArgumentException
adminComponentName: ComponentName	ComponentName ของผู้ดูแลระบบ DeviceAdminReceiver ของ DPC ที่เรียกใช้
migrationRequest: DpcMigrationRequest	DpcMigrationRequest ที่มีโทเค็นการย้ายข้อมูลและเครือข่าย Wi-Fi ที่กำหนดค่าไว้ คุณจำเป็นต้องใช้หมายเลขหลังก็ต่อเมื่อผู้โทรเป็นเจ้าของโปรไฟล์ในอุปกรณ์ส่วนตัวและกำหนดค่าเครือข่ายไว้

การคืนสินค้า

ListenableFuture<DpcMigrationAttempt>

ListenableFuture ที่รวมผลลัพธ์ ประเภทรายการได้แก่ การห่อ DpcMigrationAttempt ที่ประสบความสำเร็จในอนาคตในกรณีที่ประสบความสำเร็จ การรวม SecurityException จะไม่สำเร็จในอนาคต หากผู้โทรไม่ใช่เจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ การรวม IllegalArgumentException ล้มเหลวในอนาคต หากโทเค็นการย้ายข้อมูลว่างเปล่า หรือหาก notificationServiceComponentName ไม่ได้อ้างถึงคอมโพเนนต์ที่ถูกต้องที่ขยาย NotificationReceiverService ซึ่งส่งออกในไฟล์ Manifest หรือหาก adminComponentName ไม่ใช่ผู้ดูแลระบบที่ใช้งานอยู่ในแพ็กเกจปัจจุบัน ล้มเหลวในการรวม DpcMigrationException ในอนาคต หากการเรียกใช้ที่เกี่ยวข้องกับการย้ายข้อมูล dpc ล้มเหลว ข้อความและประเภทย่อยของข้อยกเว้นมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว

migrateDeviceManagementToAndroidManagementApiAwait

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

ย้ายข้อมูลอุปกรณ์นี้เพื่อรับการจัดการโดย Android Management API

เมื่อย้ายข้อมูลเสร็จสมบูรณ์แล้ว แอปการโทรจะสูญเสียสิทธิ์เจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ เนื่องจากสิทธิ์เหล่านี้จะโอนไปยัง Android Device Policy

คำเตือน: การดำเนินการนี้เลิกทำไม่ได้ การระงับจะส่งกลับสนุกเมื่อ Android Device Policy ได้รับคำขอและการตรวจสอบเบื้องต้นเกี่ยวกับโทเค็นการย้ายข้อมูล ในกรณีที่ล้มเหลว จะมีการส่ง Exception

มีเพียงเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์เท่านั้นที่จะเรียกใช้วิธีการนี้ได้ ใน Android 10 และต่ำกว่า ต้องไม่เรียกใช้การตั้งค่านี้ในอุปกรณ์ที่มีทั้งเจ้าของอุปกรณ์และเจ้าของโปรไฟล์

เจ้าของโปรไฟล์ (ยกเว้นใน Android 12) จะต้องส่งเครือข่าย Wi-Fi ที่กำหนดค่าไว้ในอุปกรณ์ส่วนตัวหากได้กำหนดค่าเครือข่าย Wi-Fi ไว้ภายใน DpcMigrationRequest และจะต้องไม่ส่งข้อมูลเหล่านี้เข้ามาในอุปกรณ์ของบริษัท โปรดทราบว่าเราจะนำเครือข่าย Wi-Fi เหล่านี้ออกก่อนที่จะย้ายข้อมูลการจัดการอุปกรณ์ไปยัง Android Device Policy ในกรณีที่นำเครือข่ายออกไม่สำเร็จ การย้ายข้อมูลก็จะล้มเหลวด้วย และเนื่องจากการนำเครือข่ายออกไม่ใช่การดำเนินการแบบปรมาณู บางเครือข่ายจึงอาจถูกนำออกไปแล้ว

ในอุปกรณ์ส่วนตัวที่มีโปรไฟล์งานซึ่งใช้ Android 12 ระบบจะนำเครือข่าย Wi-Fi ทั้งหมดที่กำหนดค่าโดย DPC สำหรับการโทรออกก่อนที่จะย้ายข้อมูลการจัดการอุปกรณ์ไปยัง Android Device Policy ไม่ว่าเครือข่าย Wi-Fi ที่ส่งใน migrationRequest จะเป็นอย่างไรก็ตาม

พารามิเตอร์
notificationServiceComponentName: ComponentName	ComponentNameของบริการที่ขยาย NotificationReceiverService โดยต้องเป็นคอมโพเนนต์ที่ถูกต้องที่เป็นของแอปที่โทรและส่งออกในไฟล์ Manifest มิเช่นนั้น จะมีการส่ง IllegalArgumentException
adminComponentName: ComponentName	ComponentName ของผู้ดูแลระบบ DeviceAdminReceiver ของ DPC ที่เรียกใช้
migrationRequest: DpcMigrationRequest	DpcMigrationRequest ที่มีโทเค็นการย้ายข้อมูลและเครือข่าย Wi-Fi ที่กำหนดค่าไว้ คุณจำเป็นต้องใช้หมายเลขหลังก็ต่อเมื่อผู้โทรเป็นเจ้าของโปรไฟล์ในอุปกรณ์ส่วนตัวและกำหนดค่าเครือข่ายไว้

การคืนสินค้า
DpcMigrationAttempt	DpcMigrationException พร้อมสถานะปัจจุบันของการย้ายข้อมูลในกรณีที่สำเร็จ

การขว้าง
java.lang.SecurityException	หากผู้โทรไม่ใช่เจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์
java.lang.IllegalArgumentException	หากโทเค็นการย้ายข้อมูลว่างเปล่า หรือหาก notificationServiceComponentName ไม่ได้อ้างถึงคอมโพเนนต์ที่ถูกต้องที่ขยาย NotificationReceiverService ซึ่งส่งออกในไฟล์ Manifest หรือหาก adminComponentName ไม่ใช่ผู้ดูแลระบบที่ใช้งานอยู่ในแพ็กเกจปัจจุบัน
com.google.android.managementapi.dpcmigration.DpcMigrationException	หากการโทรที่เกี่ยวข้องกับการย้ายข้อมูล dpc ล้มเหลว ข้อความและประเภทย่อยของข้อยกเว้นมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว