المعرّفات

يحتوي 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'}

مزيد من المعلومات