المعرّفات

تتضمن حزمة 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'}

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