מזהים

DeviceIdentifier הוא עטיפה של מזהי חומרה לצורך זיהוי מכשיר שיוצרו. במסמך הזה מוסבר איך לעבוד עם מזהים ב-API להרשמה ללא מגע.

DeviceIdentifier משלבת מטא-נתונים או מזהים של חומרה שנדרשים כדי לזהות מכשיר באופן ייחודי.

הארגון שלכם כולל את הערכים של מזהי המכשירים כשאתם מעלים נתוני מכשירים דרך הפורטל או קוראים ל-API.

שדות חובה

מכשירי Android

בדרך כלל, במסגרת ההרשמה ללא מגע המכשירים מזוהים לפי מזהי המודם הסלולרי (IMEI או MEID). כדי לתמוך במכשירים ללא מודם סלולרי, כמו טאבלטים, אפשר לזהות מכשירים גם באמצעות קבוצה אחרת של שדות. בטבלה הבאה מפורטים השדות שאפשר להשתמש בהם לכל סוג מכשיר:

מזהה רשת סלולרית Wi-Fi בלבד הערות
hardware_id בשדה הזה צריך להזין מספר IMEI או MEID. התהליך של הרשמה ללא מגע מאמת את הפורמט של ערכי IMEI כשאתם מעבירים אותם בארגומנטים של API.
hardware_id2 השדה הזה חייב להכיל מספר IMEI או MEID שני. התהליך של הרשמה ללא מגע מאמת את הפורמט של ערכי IMEI כשאתם מעבירים אותם בארגומנטים של API. מידע על מכשירים עם יותר ממכשיר מודם סלולרי אחד זמין במאמר מכשירים עם שתי כרטיסי SIM.
serialNumber המספר הסידורי של המכשיר לפי היצרן. המספר הסידורי תלוי אותיות רישיות, והוא זהה לערך שמוחזר מהפונקציה Build.getSerial().
model הערך של דגם המכשיר חייב להתאים לערך המובנה של המכשיר שמוחזרים מ-Build.MODEL. רשימת הערכים המותרים לכל יצרן מופיעה במאמר העזרה בנושא שמות מודלים.
manufacturer הערך בשדה manufacturer חייב להתאים לערך המובנה של המכשיר שמוחזרים מ-Build.MANUFACTURER. מידע נוסף זמין במאמר העזרה בנושא שמות יצרנים.

אם רושמים את המספר הסידורי, צריך גם לרשום את היצרן והדגם כדי לוודא שהמכשיר יזוהה באמצעות Zero-touch.

מכשירים עם שני כרטיסי 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'}

מידע נוסף