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

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, либо серийный номер, производителя и модель.

Чтобы отобразить второй 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();

Питон 

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

Питон 

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

Узнать больше