DpcMigrationClient

Kotlin |Java

public interface DpcMigrationClient

---

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

สรุป

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

เมธอดสาธารณะ

getMigrationAttempt

abstract @NonNull ListenableFuture<DpcMigrationAttempt> getMigrationAttempt(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

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

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

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

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

@NonNull ListenableFuture<DpcMigrationAttempt>

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

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

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

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

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

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

ส่ง
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>>

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

listMigrationAttemptsAwait

abstract @NonNull List<@NonNull DpcMigrationAttempt> listMigrationAttemptsAwait()

แสดงผลรายการความพยายามในการย้ายข้อมูลทั้งหมด

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

การคืนสินค้า
@NonNull List<@NonNull DpcMigrationAttempt>	รายการ 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

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

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

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

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

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

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

@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

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

migrateDeviceManagementToAndroidManagementApiAwait

abstract @NonNull DpcMigrationAttempt migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

ย้ายข้อมูลอุปกรณ์นี้ให้ Android Management API จัดการ

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

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

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

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

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

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

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

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