شناسه‌ها

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

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

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

قسمت‌های الزامی

دستگاه‌های Android

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

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

اگر شماره سریال را ثبت می‌کنید، باید سازنده و مدل را هم ثبت کنید تا مطمئن شوید zero-touch می‌تواند دستگاه را شناسایی کند.

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

دستگاه دوسیم‌کارته شامل دو مودم مجزا است و دو شماره 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 استفاده شده است:

جاوا

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

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

قطعه کد زیر نحوه ایجاد شناسه دستگاه با شماره سریال را نشان می‌دهد:

جاوا

// 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"
};

Python

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

بیشتر بدانید