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 ความล้มเหลวในการรวม 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 ไว้ในอนาคตจะประสบความสำเร็จในกรณีที่สำเร็จ ความล้มเหลวในการรวม 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 และต่ำกว่า ต้องไม่เรียกใช้การตั้งค่านี้ในอุปกรณ์ที่มีทั้งเจ้าของอุปกรณ์และเจ้าของโปรไฟล์

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

ในอุปกรณ์ส่วนตัวที่มีโปรไฟล์งานซึ่งใช้ Android 12 ระบบจะนำเครือข่าย Wi-Fi ทั้งหมดที่กำหนดค่าโดย DPC สำหรับการโทรออกก่อนที่จะย้ายข้อมูลการจัดการอุปกรณ์ไปยัง Android Device Policy ไม่ว่าเครือข่าย 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 ที่ประสบความสำเร็จในอนาคตในกรณีที่ประสบความสำเร็จ การรวม SecurityException จะไม่สำเร็จในอนาคต หากผู้โทรไม่ใช่เจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ การรวม IllegalArgumentException ล้มเหลวในอนาคต หากโทเค็นการย้ายข้อมูลว่างเปล่า หรือหาก notificationServiceComponentName ไม่ได้อ้างถึงคอมโพเนนต์ที่ถูกต้องที่ขยาย NotificationReceiverService ซึ่งส่งออกในไฟล์ Manifest หรือหาก adminComponentName ไม่ใช่ผู้ดูแลระบบที่ใช้งานอยู่ในแพ็กเกจปัจจุบัน ล้มเหลวในการรวม DpcMigrationException ในอนาคต หากการเรียกใช้ที่เกี่ยวข้องกับการย้ายข้อมูล dpc ล้มเหลว ข้อความและประเภทย่อยของข้อยกเว้นมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว

migrateDeviceManagementToAndroidManagementApiAwait

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

ย้ายข้อมูลอุปกรณ์นี้เพื่อรับการจัดการโดย 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 จะเป็นอย่างไรก็ตาม

พารามิเตอร์
@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 ล้มเหลว ข้อความและประเภทย่อยของข้อยกเว้นมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว