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، في حال النجاح. قيمة فارغة للالتفاف مستقبلي، في حال عدم العثور على 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	في حال تعذّر تنفيذ المكالمة المتعلّقة بنقل بيانات 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.

تحذير: لا يمكن التراجع عن هذا الإجراء وتكتمل عملية الاستماع التي تم إرجاعها عند استلام تطبيق Android Device Policy للطلب وإكمال عمليات التحقق الأولية بشأن الرمز المميّز لنقل البيانات. في حال تعذُّر إكمال الملف، سيتم وضع علامة Exception في المربّع.

لا يمكن استدعاء هذه الطريقة إلا من قِبل مالك الجهاز أو مالك الملف الشخصي. على نظام التشغيل Android 10 والإصدارات الأقدم، يجب عدم طلب هذا الإجراء على جهاز يتضمّن كلاً من مالك الجهاز ومالك الملف الشخصي.

يجب أن يتيح مالك الملف الشخصي استخدام شبكات Wi-Fi التي تم ضبطها في DpcMigrationRequest (باستثناء الأجهزة التي تعمل بالإصدار 12 من نظام التشغيل Android) على جهاز يملكه المستخدم الشخصي في حال تم ضبط أي شبكات Wi-Fi عليه. ويجب عدم تمريرها على جهاز مملوك للشركة. يُرجى العلم بأنّه ستتم إزالة شبكات Wi-Fi هذه قبل نقل إدارة الأجهزة إلى تطبيق Android Device Policy مباشرةً. وفي حال تعذُّر إزالة إحدى الشبكات، لن تنجح عملية النقل أيضًا، وبما أنّ عملية إزالة الشبكات ليست عملية ذرية، ربما سبق أن تمّت إزالة بعض الشبكات.

على الأجهزة الشخصية التي تتضمن ملفًا شخصيًا للعمل يعمل بنظام التشغيل Android 12، ستتم إزالة جميع شبكات Wi-Fi التي تم ضبطها من خلال وحدة التحكّم بسياسة الجهاز المتصل مباشرةً قبل نقل إدارة الجهاز إلى Android Device Policy، وذلك بغض النظر عن شبكات Wi-Fi المعتمَدة في migrationRequest.

المَعلمات
@NonNull ComponentName notificationServiceComponentName	ComponentName للخدمة التي تم تمديدها NotificationReceiverService. يجب أن يكون مكوِّنًا صالحًا ينتمي إلى تطبيق الاتصال وأن يتم تصديره في ملف البيان، وإلا سيتم تجاهل IllegalArgumentException.
@NonNull ComponentName adminComponentName	ComponentName للمشرف DeviceAdminReceiver على وحدة التحكّم بسياسة الجهاز المتصل
@NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest الذي يحتوي على الرمز المميّز للنقل وشبكات Wi-Fi التي تم ضبطها ولا يلزم استخدام الخيار الثاني إلا إذا كان المتصل هو مالك الملف الشخصي على جهاز يملكه شخص شخصيًا وأجرى إعدادًا لأي شبكات.

المرتجعات

@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

علامة ListenableFuture تلفّ النتيجة يمكن أن تظهر فائدة هذا بوضوح أكبر مستقبل ناجح يختتم DpcMigrationAttempt، في حال النجاح. تعذّر إتمام عملية التفاف SecurityException في المستقبل، إذا لم يكن المتصل مالك جهاز أو مالك ملف شخصي. تعذّر إتمام عملية التفاف IllegalArgumentException في المستقبل، أو إذا كان الرمز المميّز لنقل البيانات فارغًا، أو إذا كان notificationServiceComponentName لا يشير إلى مكوّن صالح يوسّع NotificationReceiverService الذي يتم تصديره في البيان، أو إذا لم يكن 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 والإصدارات الأقدم، يجب عدم طلب هذا الإجراء على جهاز يتضمّن كلاً من مالك الجهاز ومالك الملف الشخصي.

يجب أن يتيح مالك الملف الشخصي استخدام شبكات Wi-Fi التي تم ضبطها في DpcMigrationRequest (باستثناء الأجهزة التي تعمل بالإصدار 12 من نظام التشغيل Android) على جهاز يملكه المستخدم الشخصي في حال تم ضبط أي شبكات Wi-Fi عليه. ويجب عدم تمريرها على جهاز مملوك للشركة. يُرجى العلم بأنّه ستتم إزالة شبكات Wi-Fi هذه قبل نقل إدارة الأجهزة إلى تطبيق Android Device Policy مباشرةً. وفي حال تعذُّر إزالة إحدى الشبكات، لن تنجح عملية النقل أيضًا، وبما أنّ عملية إزالة الشبكات ليست عملية ذرية، ربما سبق أن تمّت إزالة بعض الشبكات.

على الأجهزة الشخصية التي تتضمن ملفًا شخصيًا للعمل يعمل بنظام التشغيل Android 12، ستتم إزالة جميع شبكات Wi-Fi التي تم ضبطها من خلال وحدة التحكّم بسياسة الجهاز المتصل مباشرةً قبل نقل إدارة الجهاز إلى Android Device Policy، وذلك بغض النظر عن شبكات Wi-Fi المعتمَدة في migrationRequest.

المَعلمات
@NonNull ComponentName notificationServiceComponentName	ComponentName للخدمة التي تم تمديدها NotificationReceiverService. يجب أن يكون مكوِّنًا صالحًا ينتمي إلى تطبيق الاتصال وأن يتم تصديره في ملف البيان، وإلا سيتم تجاهل IllegalArgumentException.
@NonNull ComponentName adminComponentName	ComponentName للمشرف DeviceAdminReceiver على وحدة التحكّم بسياسة الجهاز المتصل
@NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest الذي يحتوي على الرمز المميّز للنقل وشبكات Wi-Fi التي تم ضبطها ولا يلزم استخدام الخيار الثاني إلا إذا كان المتصل هو مالك الملف الشخصي على جهاز يملكه شخص شخصيًا وأجرى إعدادًا لأي شبكات.

المرتجعات
@NonNull DpcMigrationAttempt	DpcMigrationException مع الحالة الحالية لعملية نقل البيانات في حال نجاحها

الرميات
java.lang.SecurityException	إذا لم يكن المتصل مالكًا للجهاز أو مالكًا لملف شخصي.
java.lang.IllegalArgumentException	إذا كان الرمز المميّز لنقل البيانات فارغًا، أو إذا كان notificationServiceComponentName لا يشير إلى مكوّن صالح يعمل على توسيع NotificationReceiverService الذي يتم تصديره في البيان، أو إذا لم يكن adminComponentName مشرفًا نشطًا ينتمي إلى الحزمة الحالية.
com.google.android.managementapi.dpcmigration.DpcMigrationException	في حال تعذّر تنفيذ المكالمة المتعلّقة بنقل بيانات dPC. تحتوي الرسالة والنوع الفرعي للاستثناء على مزيد من التفاصيل حول الخطأ.