تتضمن حزمة DeviceIdentifier
أرقام تعريف الأجهزة لتحديد
الجهاز الذي تم تصنيعه. يوضّح هذا المستند كيفية التعامل مع المعرّفات في
واجهة برمجة التطبيقات لبرنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة".
يدمج DeviceIdentifier
البيانات الوصفية للأجهزة أو أرقام التعريف المطلوبة لتعريف الجهاز بشكل فريد.
تتضمن مؤسستك قيم معرّفات الجهاز عند تحميل بيانات الجهاز
من خلال البوابة أو استدعاء واجهة برمجة التطبيقات. بما أنّ مثيلات DeviceIdentifier
غير قابلة للتغيير، لا يمكنك استخدام واجهة برمجة التطبيقات لتغيير قيم الحقول.
حقول مطلوبة
الأجهزة التي تعمل بنظام التشغيل Android
يتعرّف برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" عادةً على الأجهزة من خلال أرقام تعريف مودم الجوّال IMEI (أو MEID). ولكن لدعم الأجهزة التي لا تحتوي على أجهزة مودم خلوية، مثل الأجهزة اللوحية، يمكنك أيضًا تحديد الأجهزة باستخدام مجموعة مختلفة من الحقول. يوضح الجدول التالي الحقول المطلوبة لكل نوع من الأجهزة:
المُعرّف | شبكة الجوّال | Wi-Fi فقط | Notes |
---|---|---|---|
hardware_id |
يجب أن يكون هذا الحقل رقم IMEI أو MEID. يتحقّق برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" من تنسيق قيم IMEI عند تمريرها في وسيطات واجهة برمجة التطبيقات. بالنسبة إلى الأجهزة التي تحتوي على أكثر من مودم خلوي واحد، راجِع أجهزة بشريحتَي SIM. | ||
serialNumber |
يشير إلى الرقم التسلسلي الخاص بالشركة المصنّعة للجهاز. الرقم التسلسلي حسّاس لحالة الأحرف، وهو هو القيمة نفسها التي يتم عرضها من Build.getSerial() . |
||
model |
يجب أن تتطابق قيمة طراز الجهاز مع القيمة المضمّنة في الجهاز التي تم عرضها من Build.MODEL . راجِع مرجع أسماء النماذج للاطّلاع على قائمة بالقيم المسموح بها لكل شركة مصنّعة. |
||
manufacturer |
لكي يعمل برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" مع جهاز Wi-Fi فقط، يجب أن تتطابق قيمة الحقل manufacturer مع القيمة المضمّنة في الجهاز التي تم عرضها من Build.MANUFACTURER . إنّ الحقل manufacturer هو حقل اختياري للأجهزة الجوّالة، ولكن ننصح به لأنّه يسهّل على العملاء التعرّف على أجهزتهم. راجع مرجع أسماء الشركات المصنِّعة للحصول على مزيد من المعلومات. |
إذا لم يكن الجهاز يحتوي على مودم خلوي، مثل جهاز فحص لمخزون الأجهزة اللوحية أو المستودع، استخدِم حقول Wi-Fi فقط. بالنسبة لجميع الأجهزة الأخرى، استخدم الحقول الخلوية.
أجهزة بشريحتَي SIM
يشتمل أي جهاز بشريحتَي SIM على مودمَين منفصلَين ويكون له رقما IMEI. استخدِم الرقم الأصغر من رقمَي IMEI، لأنّ برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" يعمل بشكل أكثر موثوقية مع الرقم الأصغر من رقمَي IMEI.
أجهزة ChromeOS
بالنسبة إلى أجهزة ChromeOS، تكون مجموعة المعرّفات المطلوبة هي نفسها للأجهزة الجوّالة وشبكة Wi-Fi فقط:
المُعرّف | Notes |
---|---|
serialNumber
|
والرقم التسلسلي للشركة المصنعة للجهاز. |
model
|
يجب أن تتطابق قيمة طراز الجهاز مع القيمة المضمّنة في الجهاز. ويمكنك الاطّلاع على قائمة قيم طرازات ChromeOS كمرجع. |
chromeOsAttestedDeviceId
|
رقم تعريف الجهاز الذي تم التصديق عليه يمكنك الاطّلاع على قائمة أجهزة ChromeOS المتوافقة للرجوع إليها. |
الإشارة إلى جهاز
استخدِم "DeviceIdentifier
" عند العثور على الأجهزة أو المطالبة بها. تحتاج إلى تضمين الحقول
المطلوبة المحددة لنوع الجهاز.
يعرض المقتطف التالي رقم IMEI المستخدَم للبحث عن جهاز معيّن من خلال طلب الرقم partners.devices.findByIdentifier
:
Java
// Create a DeviceIdentifier. DeviceIdentifier deviceIdentifier = new DeviceIdentifier(); deviceIdentifier.setImei("123456789012347"); // Perform the search using the zero-touch enrollment API. FindDevicesByDeviceIdentifierRequest body = new FindDevicesByDeviceIdentifierRequest(); body.setLimit(1L); body.setDeviceIdentifier(deviceIdentifier); FindDevicesByDeviceIdentifierResponse response = service .partners() .devices() .findByIdentifier(PARTNER_ID, body) .execute();
NET.
// Create a DeviceIdentifier. var deviceIdentifier = new DeviceIdentifier { Imei = "123456789012347" }; // Perform the search using the zero-touch enrollment API. var body = new FindDevicesByDeviceIdentifierRequest { Limit = 1, DeviceIdentifier = deviceIdentifier }; var response = service.Partners.Devices.FindByIdentifier(body, PartnerId).Execute();
Python
# Create a DeviceIdentifier. device_identifier = {'imei':'123456789012347'} # Perform the search using the zero-touch enrollment API. response = service.partners().devices().findByIdentifier( partnerId=PARTNER_ID, body={'deviceIdentifier':device_identifier, \ 'limit':1}).execute()
يعرض المقتطف التالي كيفية إنشاء معرّف جهاز لشبكة Wi-Fi فقط:
Java
// Create a device identifier to find a Wi-Fi-only device. DeviceIdentifier deviceIdentifier = new DeviceIdentifier(); deviceIdentifier.setManufacturer("Honeywell"); deviceIdentifier.setModel("VM1A"); deviceIdentifier.setSerialNumber("ABcd1235678");
NET.
// Create a device identifier to find a Wi-Fi-only device. var deviceIdentifier = new DeviceIdentifier { Manufacturer = "Honeywell", Model = "VM1A", SerialNumber = "ABcd1235678" };
Python
# Create a device identifier to find a Wi-Fi-only device. device_identifier = {'manufacturer':'Honeywell', \ 'model':'VM1A', 'serialNumber':'ABcd1235678'}
مزيد من المعلومات
- للمزيد من المعلومات حول معرّفات الأجهزة، يمكنك الاطّلاع على
المستندات المرجعية لواجهة برمجة التطبيقات التي تخص
DeviceIdentifier
. - للاطّلاع على قائمة بأسماء الشركات المصنِّعة وطُرز الأجهزة المسموح بها، يمكنك مراجعة مرجع أسماء الشركات المصنِّعة.
- للاطّلاع على قائمة بأجهزة ChromeOS المتوافقة، يمكنك الانتقال إلى مركز مساعدة ChromeOs.