Identyfikatory

DeviceIdentifier zawiera identyfikatory sprzętowe, które służą do identyfikowania wyprodukowanego urządzenia. Z tego dokumentu dowiesz się, jak pracować z identyfikatorami w interfejsie API rejestracji typu zero-touch.

DeviceIdentifier to kombinacja metadanych sprzętu lub identyfikatorów, które są wymagane do jednoznacznej identyfikacji urządzenia.

Organizacja podaje wartości identyfikatora urządzenia podczas przesyłania danych urządzenia przez portal lub wywoływanie interfejsu API.

Pola wymagane

urządzeniach z Androidem,

Rejestracja typu zero-touch zwykle identyfikuje urządzenia według identyfikatorów IMEI (lub MEID) modemu komórkowego. Aby obsługiwać urządzenia bez modemów komórkowych, np. tablety, możesz też identyfikować urządzenia za pomocą innego zestawu pól. W tabeli poniżej znajdziesz pola, których możesz używać w przypadku poszczególnych typów urządzeń:

Identyfikator Sieć komórkowa Tylko Wi-Fi Uwagi
hardware_id To pole musi zawierać numer IMEI lub MEID. Rejestracja bezdotykowa sprawdza poprawność formatu wartości IMEI, gdy przekazujesz je w argumentach interfejsu API.
hardware_id2 To pole musi zawierać drugi numer IMEI lub MEID. Rejestracja bezdotykowa sprawdza format wartości IMEI, gdy przekazujesz je w argumentach interfejsu API. Informacje o urządzeniach z więcej niż 1 modemem komórkowym znajdziesz w artykule Urządzenia z dual SIM.
serialNumber Numer seryjny urządzenia podany przez producenta. Wielkość liter w numerze seryjnym ma znaczenie. Jest to ta sama wartość, która jest zwracana przez funkcję Build.getSerial().
model Wartość modelu urządzenia musi być zgodna z wbudowaną wartością urządzenia zwracaną przez Build.MODEL. Listę dozwolonych wartości dla każdego producenta znajdziesz w dokumentacji dotyczącej nazw modeli.
manufacturer Wartość pola manufacturer musi być zgodna z wbudowaną wartością urządzenia zwracaną przez Build.MANUFACTURER. Więcej informacji znajdziesz w nawiązaniu do nazw producentów.

Jeśli rejestrujesz numer seryjny, musisz też podać producenta i model, aby umożliwić wykrycie urządzenia przez rejestrację typu zero-touch.

Urządzenia z 2 kartami SIM

Urządzenie dual SIM ma 2 oddzielne modemy i 2 numery IMEI. Jeśli rejestrujesz tylko 1 numer IMEI, użyj najniższego numeru IMEI, ponieważ rejestracja typu zero-touch działa niezawodniej z najniższym numerem IMEI. Aby zwiększyć niezawodność, możesz dodatkowo zarejestrować inny numer IMEI lub numer seryjny, producenta i model.

Aby wyświetlić drugi numer IMEI w portalu Zero-Touch:

  1. Otwórz kartę Urządzenia.
  2. W prawym górnym rogu obok przycisku Dodaj urządzenie kliknij 3 kropki .
  3. Wybierz Dostosuj tabelę.
  4. Zaznacz pole wyboru IMEI2.
  5. Kliknij Zapisz.

Urządzenia z ChromeOS

W przypadku urządzeń z ChromeOS zestaw wymaganych identyfikatorów jest taki sam w przypadku urządzeń z dostępem do sieci komórkowej i tylko Wi-Fi:

Identyfikator Uwagi
serialNumber Numer seryjny urządzenia podany przez producenta.
model Wartość modelu urządzenia musi być zgodna z wartością wbudowaną w urządzenie. Aby się z nimi zapoznać, zobacz listę wartości modeli ChromeOS.
chromeOsAttestedDeviceId Identyfikator atestowanego urządzenia. Informacje na ten temat znajdziesz na liście zgodnych urządzeń z ChromeOS.

Odnoś się do urządzenia

Używaj DeviceIdentifier podczas znajdowania i reklamowania urządzeń. Musisz uwzględnić wymagane pola określone dla danego typu urządzenia.

Poniższy fragment kodu pokazuje numer IMEI używany do wyszukiwania konkretnego urządzenia przez wywołanie funkcji 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()

Ten fragment kodu pokazuje, jak utworzyć identyfikator urządzenia za pomocą numeru seryjnego:

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'}

Więcej informacji