المعرفات

يُحاط معرّفات الأجهزة في DeviceIdentifier لتحديد هوية الجهاز المصنّع. يوضّح هذا المستند كيفية التعامل مع المعرّفات في واجهة برمجة التطبيقات zero-touch enrollment API.

يجمع DeviceIdentifier البيانات الوصفية للأجهزة أو المعرّفات المطلوبة لتحديد جهاز معيّن بشكلٍ فريد.

تُدرِج مؤسستك قيم معرّفات الأجهزة عند تحميل data الأجهزة من خلال البوابة أو طلب بيانات من واجهة برمجة التطبيقات.

حقول مطلوبة

الأجهزة التي تعمل بنظام التشغيل Android

يتعرّف برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" عادةً على الأجهزة من خلال أرقام تعريف IMEI (أو MEID) للمودم الخلوي. لتتوافق مع الأجهزة التي لا تتضمّن أجهزة مودم خلوي، مثل الأجهزة اللوحية، يمكنك أيضًا تحديد الأجهزة باستخدام مجموعة مختلفة من الحقول. يوضّح الجدول التالي الحقول التي يمكنك استخدامها لكل نوع من أنواع الأجهزة:

المُعرّف شبكة الجوّال شبكة Wi‑Fi فقط ملاحظات
hardware_id يجب أن يحتوي هذا الحقل على رقم IMEI أو MEID. تتحقّق ميزة "إعداد الأجهزة الجوّالة للمؤسسات بدون تلامس" من صحة تنسيق قيم IMEI عند تمريرها في مَعلمات واجهة برمجة التطبيقات.
hardware_id2 يجب أن يكون هذا الحقل رقم IMEI أو MEID ثانٍ. تتحقّق ميزة "إعداد الأجهزة الجوّالة للمؤسسات بدون تلامس" من صحة تنسيق قيم IMEI عند تمريرها في مَعلمات واجهة برمجة التطبيقات. للحصول على معلومات عن الأجهزة التي تحتوي على أكثر من مودم خلوي واحد، يُرجى الاطّلاع على الأجهزة المزوّدة بشريحتَي SIM.
serialNumber الرقم التسلسلي للجهاز المحدّد من الشركة المصنّعة الرقم التسلسلي حسّاس لحالة الأحرف وهو القيمة نفسها التي يتم عرضها من Build.getSerial().
model يجب أن تتطابق قيمة طراز الجهاز مع القيمة المدمجة للجهاز التي يتم عرضها من Build.MODEL. اطّلِع على مرجع أسماء الطُرز للحصول على قائمة بالقيم المسموح بها لكل شركة تصنيع.
manufacturer يجب أن تتطابق قيمة الحقل manufacturer مع القيمة المدمجة للجهاز التي يتم عرضها من Build.MANUFACTURER. راجِع مرجع أسماء الشركات المصنّعة للحصول على مزيد من المعلومات.

في حال تسجيل الرقم التسلسلي، يجب أيضًا تسجيل الشركة المصنّعة والطراز ل ensure zero-touch is able to detect the device.

الأجهزة المزوّدة بشريحتَي SIM

يشتمل أي جهاز بشريحتَي SIM على مودمَين منفصلَين ويكون له رقما IMEI. في حال تسجيل رقم IMEI واحد فقط، يُفضَّل استخدام الرقم الأصغر من رقمَي IMEI لأنّ ميزة "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" تعمل بشكل أكثر موثوقية مع الرقم الأصغر من رقمَي IMEI. لزيادة الموثوقية، يمكنك أيضًا تسجيل رقم IMEI الآخر أو الرقم التسلسلي والشركة المصنّعة والطراز.

لعرض رقم IMEI الثاني في منصة "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة"، اتّبِع الخطوات التالية:

  1. انتقِل إلى علامة التبويب الأجهزة.
  2. في أعلى يسار الصفحة، بجانب الزر إضافة جهاز، انقر على رمز النقاط الثلاث .
  3. اختَر تخصيص الجدول.
  4. ضَع علامة في مربّع الاختيار IMEI2.
  5. انقر على حفظ.

أجهزة 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()

يوضِّح المقتطف التالي كيفية إنشاء معرّف جهاز باستخدام رقم تسلسلي:

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'}

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