يحتوي DeviceIdentifier
على معرّفات الأجهزة لتحديد
الجهاز المصنع. يشرح هذا المستند كيفية استخدام المعرّفات في
واجهة برمجة التطبيقات لعملية "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة".
يجمع DeviceIdentifier
بين البيانات الوصفية للأجهزة أو أرقام التعريف المطلوبة
للتعرف على جهاز.
تتضمن مؤسستك قيم معرّفات الأجهزة عند تحميل الجهاز.
البيانات من خلال البوابة أو من خلال طلب بيانات من واجهة برمجة التطبيقات. لأنّ DeviceIdentifier
أمثلة
غير قابلة للتغيير، فلا يمكنك استخدام واجهة برمجة التطبيقات لتغيير قيم الحقول.
حقول مطلوبة
الأجهزة التي تعمل بنظام التشغيل Android
يحدِّد برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" الأجهزة عادةً من خلال رمز IMEI (أو MEID). معرفات المودم الخلوية. ولكن لدعم الأجهزة التي لا تحتوي على أجهزة مودم خلوية، مثل الأجهزة اللوحية، يمكنك أيضًا تحديد الأجهزة التي تستخدم مجموعة مختلفة من الحقول. تشير رسالة الأشكال البيانية يعرض الجدول التالي الحقول المطلوبة لكل نوع من الأجهزة:
المُعرّف | شبكة الجوّال | Wi‐Fi فقط | ملاحظات |
---|---|---|---|
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 فقط:
المُعرّف | ملاحظات |
---|---|
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