DpcMigrationClient

Kotlin |Java

public interface DpcMigrationClient

---

يجب أن يقدّم العميل طلبات ذات صلة بنقل البيانات إلى حساب مطوّر آخر.

ملخّص

الإجراءات العامة
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
abstract @NonNull DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) نقل هذا الجهاز ليتم إدارته من خلال واجهة برمجة التطبيقات لإدارة Android

الإجراءات العامة

getMigrationAttempt

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

تعرض هذه الطريقة محاولة نقل بيانات.

إذا لم يتم تحديد اسم في GetDpcMigrationAttemptRequest، سيتم عرض أحدث DpcMigrationAttempt.

لا يمكن استدعاء هذه الطريقة إلا من خلال "مالك الجهاز" أو "مالك الملف الشخصي" أو "مالك الجهاز" أو "مالك الملف الشخصي" السابق الذي تمّت نقل بياناته إلى "واجهة برمجة التطبيقات لإدارة Android".

المرتجعات

@NonNull ListenableFuture<DpcMigrationAttempt>

ListenableFuture يلتف حول النتيجة. يمكن أن يكون ذلك تمثّل هذه السمة عملية ناجحة تتضمّن DpcMigrationAttempt، في حال النجاح. تعرض هذه السمة قيمة فارغة في حال عدم العثور على DpcMigrationAttempt. قيمة مستقبلية غير ناجحة تتضمّن SecurityException، في حال لم يكن المتصل "مالك الجهاز" أو "مالك الملف الشخصي"، أو كان "مالك الجهاز" أو "مالك الملف الشخصي" سابقًا وتم نقل بياناته إلى واجهة برمجة التطبيقات لإدارة Android حالة فشل في عملية التغليف المستقبلية DpcMigrationException في حال تعذّر إجراء مكالمة متعلقة بنقل البيانات إلى "ملف شخصي للعمل" تحتوي الرسالة والنوع الفرعي للاستثناء على مزيد من التفاصيل حول الخطأ.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

تعرض هذه الطريقة محاولة نقل بيانات.

إذا لم يتم تحديد اسم في GetDpcMigrationAttemptRequest، سيتم عرض أحدث DpcMigrationAttempt.

لا يمكن استدعاء هذه الطريقة إلا من خلال "مالك الجهاز" أو "مالك الملف الشخصي" أو "مالك الجهاز" أو "مالك الملف الشخصي" السابق الذي تمّت نقل بياناته إلى "واجهة برمجة التطبيقات لإدارة Android".

المرتجعات
DpcMigrationAttempt	DpcMigrationAttempt المطلوب أو قيمة فارغة إذا تعذّر العثور عليه

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

listMigrationAttempts

abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> listMigrationAttempts()

تعرض هذه الطريقة قائمة بجميع محاولات النقل.

لا يمكن استدعاء هذه الطريقة إلا من خلال "مالك الجهاز" أو "مالك الملف الشخصي" أو "مالك الجهاز" أو "مالك الملف الشخصي" السابق الذي تمّت نقل بياناته إلى "واجهة برمجة التطبيقات لإدارة Android". ملاحظة: يتم حذف محاولات النقل القديمة تلقائيًا ولا يتم إرجاعها.

المرتجعات

@NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

ListenableFuture يلتف حول النتيجة. يمكن أن يكون ذلك قيمة مستقبلية ناجحة تتضمّن قائمة من DpcMigrationAttempt، في حال النجاح قيمة مستقبلية غير ناجحة تتضمّن SecurityException، في حال لم يكن المتصل "مالك الجهاز" أو "مالك الملف الشخصي"، أو كان "مالك الجهاز" أو "مالك الملف الشخصي" سابقًا وتم نقل بياناته إلى واجهة برمجة التطبيقات لإدارة Android حالة فشل في عملية التغليف المستقبلية DpcMigrationException في حال تعذّر إجراء مكالمة متعلقة بنقل البيانات إلى "ملف شخصي للعمل" تحتوي الرسالة والنوع الفرعي للاستثناء على مزيد من التفاصيل حول الخطأ.

listMigrationAttemptsAwait

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

تعرض هذه الطريقة قائمة بجميع محاولات النقل.

لا يمكن استدعاء هذه الطريقة إلا من خلال "مالك الجهاز" أو "مالك الملف الشخصي" أو "مالك الجهاز" أو "مالك الملف الشخصي" السابق الذي تمّت نقل بياناته إلى "واجهة برمجة التطبيقات لإدارة Android". ملاحظة: يتم حذف محاولات النقل القديمة تلقائيًا ولا يتم إرجاعها.

المرتجعات
@NonNull List<@NonNull DpcMigrationAttempt>	قائمة DpcMigrationAttempt

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

migrateDeviceManagementToAndroidManagementApi

abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt> migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

نقل هذا الجهاز ليتم إدارته من خلال واجهة برمجة التطبيقات لإدارة Android

بعد اكتمال عملية نقل البيانات، يفقد تطبيق الاتصال امتيازات "مالك الجهاز" أو "مالك الملف الشخصي"، لأنّ هذه الامتيازات يتم نقلها إلى تطبيق "سياسة Android للأجهزة".

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

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

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

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

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

المرتجعات

@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

ListenableFuture يلتف حول النتيجة. يمكن أن يكون ذلك تمثّل هذه السمة عملية ناجحة تتضمّن DpcMigrationAttempt، في حال النجاح. يتم عرض قيمة غير صالحة في المستقبل عند تضمين SecurityException، إذا لم يكن المتصل مالك جهاز أو مالك ملف شخصي. تعذُّر تنفيذ عملية مستقبلية تتضمّن IllegalArgumentException، إذا كانت الرمز المميز لنقل البيانات فارغًا، أو إذا لم يكن notificationServiceComponentName يشير إلى مكوّن صالح يوسّع NotificationReceiverService الذي تم تصديره في ملف البيان، أو إذا لم يكن adminComponentName مشرفًا نشطًا تابعًا للحزمة الحالية. قيمة غير صالحة في المستقبل تتضمّن DpcMigrationException، في حال تعذُّر إجراء المكالمة المرتبطة بنقل البيانات إلى ملف شخصي للعمل تحتوي الرسالة والنوع الفرعي للاستثناء على مزيد من التفاصيل حول الخطأ.

migrateDeviceManagementToAndroidManagementApiAwait

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

نقل هذا الجهاز ليتم إدارته من خلال واجهة برمجة التطبيقات لإدارة Android

بعد اكتمال عملية نقل البيانات، يفقد تطبيق الاتصال امتيازات "مالك الجهاز" أو "مالك الملف الشخصي"، لأنّ هذه الامتيازات يتم نقلها إلى تطبيق "سياسة Android للأجهزة".

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

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

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

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

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

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

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