מזהים

התג 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'}

מידע נוסף