DpcMigrationClient

public interface DpcMigrationClient

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

สรุป

วิธีการสาธารณะ
abstract @NonNull ListenableFuture<DpcMigrationAttempt>
getMigrationAttempt(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

พยายามย้ายข้อมูล
abstract DpcMigrationAttempt
getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

พยายามย้ายข้อมูล
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

แสดงผลรายการของการพยายามย้ายข้อมูลทั้งหมด
abstract @NonNull List<@NonNull DpcMigrationAttempt>

แสดงผลรายการของการพยายามย้ายข้อมูลทั้งหมด
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 ที่ขอหรือไม่มีข้อมูล หากไม่พบ
การขว้าง
java.lang.SecurityException

หากผู้โทรไม่ใช่เจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์ หรือเจ้าของอุปกรณ์หรือเจ้าของโปรไฟล์คนก่อนหน้าซึ่งย้ายข้อมูลไปยัง Android Management API
com.google.android.managementapi.dpcmigration.DpcMigrationException

หากการเรียกใช้ที่เกี่ยวข้องกับการย้ายข้อมูล DCM ล้มเหลว ข้อความและประเภทย่อยของข้อยกเว้นจะมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว

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

หากการเรียกใช้ที่เกี่ยวข้องกับการย้ายข้อมูล DCM ล้มเหลว ข้อความและประเภทย่อยของข้อยกเว้นจะมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว

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

หากการเรียกใช้ที่เกี่ยวข้องกับการย้ายข้อมูล DCM ล้มเหลว ข้อความและประเภทย่อยของข้อยกเว้นจะมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว