Идентификаторы

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. Дополнительную информацию можно найти в справочнике названий производителей.

Если вы регистрируете серийный номер, то также должны указать производителя и модель, чтобы устройство можно было обнаружить во время автоматической настройки.

Устройства с двумя SIM-картами

У устройства с двумя SIM-картами есть два модема и 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'}

Подробнее…