شناسه ها

DeviceIdentifier شناسه های سخت افزاری را برای شناسایی دستگاه تولید شده در خود محصور می کند. این سند نحوه کار با شناسه ها را در API ثبت نام بدون لمس توضیح می دهد.

DeviceIdentifier فراداده‌های سخت‌افزاری یا شناسه‌های مورد نیاز برای شناسایی منحصربه‌فرد یک دستگاه را ترکیب می‌کند.

سازمان شما هنگام آپلود داده‌های دستگاه از طریق پورتال یا تماس با API، مقادیر شناسه دستگاه را شامل می‌شود. از آنجایی که نمونه های DeviceIdentifier تغییر ناپذیر هستند، نمی توانید از API برای تغییر مقادیر فیلد استفاده کنید.

فیلدهای مورد نیاز

دستگاه های اندرویدی

ثبت نام بدون لمس معمولاً دستگاه ها را با شناسه مودم سلولی IMEI (یا MEID) شناسایی می کند. اما برای پشتیبانی از دستگاه‌های بدون مودم سلولی، مانند تبلت‌ها، می‌توانید دستگاه‌ها را با استفاده از مجموعه‌ای از فیلدها شناسایی کنید. جدول زیر فیلدهای مورد نیاز برای هر نوع دستگاه را نشان می دهد:

مشخص کننده سلولی فقط وای فای یادداشت
hardware_id این فیلد باید یک شماره IMEI یا MEID باشد. ثبت نام بدون لمس، فرمت مقادیر IMEI را زمانی که آنها را در آرگومان های API ارسال می کنید، تأیید می کند. برای دستگاه‌هایی که بیش از یک مودم سلولی دارند، به دستگاه‌های دو سیم کارته مراجعه کنید.
serialNumber شماره سریال سازنده دستگاه. شماره سریال به حروف بزرگ و کوچک حساس است و همان مقداری است که از Build.getSerial() برگردانده شده است.
model مقدار مدل دستگاه باید با مقدار داخلی دستگاه برگردانده شده از Build.MODEL مطابقت داشته باشد. برای فهرستی از مقادیر مجاز برای هر سازنده به مرجع نام مدل مراجعه کنید.
manufacturer برای اینکه ثبت نام بدون لمس برای دستگاهی فقط Wi-Fi کار کند، مقدار فیلد manufacturer باید با مقدار داخلی دستگاه که از Build.MANUFACTURER برگردانده شده است مطابقت داشته باشد. برای دستگاه‌های تلفن همراه، قسمت manufacturer اختیاری است، اما توصیه می‌شود، زیرا شناسایی دستگاه‌هایشان را برای مشتریان آسان‌تر می‌کند. برای اطلاعات بیشتر به مرجع نام سازنده مراجعه کنید.

اگر دستگاه دارای مودم سلولی، به عنوان مثال تبلت یا اسکنر موجودی انبار نیست، از فیلدهای فقط Wi-Fi استفاده کنید. برای همه دستگاه‌های دیگر، از فیلدهای سلولی استفاده کنید.

دستگاه های دو سیم کارته

یک دستگاه دو سیم کارته شامل دو مودم مجزا و دارای دو شماره IMEI است. از پایین‌ترین عدد IMEI استفاده کنید زیرا ثبت‌نام با لمس صفر با کمترین IMEI مطمئن‌تر عمل می‌کند.

دستگاه های ChromeOS

برای دستگاه‌های ChromeOS، مجموعه شناسه‌های مورد نیاز برای دستگاه‌های تلفن همراه و فقط Wi-Fi یکسان است:

مشخص کننده یادداشت
serialNumber شماره سریال سازنده دستگاه.
model مقدار مدل دستگاه باید با مقدار داخلی دستگاه مطابقت داشته باشد. فهرست مقادیر مدل ChromeOS را برای مرجع ببینید.
chromeOsAttestedDeviceId شناسه دستگاه تایید شده فهرست دستگاه‌های ChromeOS سازگار را برای مرجع ببینید.

رجوع به دستگاه شود

هنگام یافتن یا ادعای دستگاه‌ها از یک DeviceIdentifier استفاده کنید. باید فیلدهای مورد نیاز مشخص شده برای نوع دستگاه را وارد کنید.

قطعه زیر یک شماره IMEI را نشان می دهد که برای جستجوی یک دستگاه خاص با تماس با partners.devices.findByIdentifier استفاده می شود:

جاوا

// 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();

.خالص

// 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();

پایتون

# 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 را نشان می دهد:

جاوا

// Create a device identifier to find a Wi-Fi-only device.
DeviceIdentifier deviceIdentifier = new DeviceIdentifier();
deviceIdentifier.setManufacturer("Honeywell");
deviceIdentifier.setModel("VM1A");
deviceIdentifier.setSerialNumber("ABcd1235678");

.خالص

// Create a device identifier to find a Wi-Fi-only device.
var deviceIdentifier = new DeviceIdentifier
{
    Manufacturer = "Honeywell",
    Model = "VM1A",
    SerialNumber = "ABcd1235678"
};

پایتون

# Create a device identifier to find a Wi-Fi-only device.
device_identifier = {'manufacturer':'Honeywell', \
    'model':'VM1A', 'serialNumber':'ABcd1235678'}

بیشتر بدانید

  • برای کسب اطلاعات بیشتر در مورد شناسه‌های سخت‌افزار، به مستندات مرجع API برای DeviceIdentifier مراجعه کنید.
  • برای دیدن لیستی از نام‌های مجاز سازنده و مدل‌های دستگاه، مرجع نام سازنده را بررسی کنید.
  • برای دیدن لیستی از دستگاه‌های ChromeOS سازگار، به مرکز راهنمای ChromeOs مراجعه کنید