מזהים

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

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

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

שדות חובה

מכשירי Android

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

מזהה רשת סלולרית בחיבור Wi-Fi בלבד הערות
hardware_id השדה הזה חייב להיות מספר IMEI או MEID. הרשמה דרך הארגון מאמתת את הפורמט של ערכי ה-IMEI כשמעבירים אותם בארגומנטים של API. למכשירים עם יותר ממודם סלולרי אחד, צריך לעיין במאמר מכשירי 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'}

מידע נוסף