Identyfikatory

DeviceIdentifier zawiera identyfikatory sprzętu, które identyfikują wyprodukowane urządzenie. Z tego dokumentu dowiesz się, jak korzystać z identyfikatorów w interfejsie API do rejestracji typu zero-touch.

DeviceIdentifier łączy metadane sprzętu lub identyfikatory wymagane do jednoznacznej identyfikacji urządzenia.

Twoja organizacja uwzględnia wartości identyfikatorów urządzeń podczas przesyłania danych urządzeń przez portal lub wywoływania interfejsu API. Instancje DeviceIdentifier są stałe, więc nie możesz zmieniać wartości pól za pomocą interfejsu API.

Pola wymagane

urządzeniach z Androidem,

Rejestracja typu zero-touch zwykle identyfikuje urządzenia na podstawie identyfikatorów IMEI (lub MEID) modemu komórkowego. Jednak aby obsługiwać urządzenia bez modemów komórkowych, takie jak tablety, możesz też identyfikować urządzenia za pomocą innego zestawu pól. W tej tabeli znajdziesz pola wymagane dla każdego typu urządzenia:

Identyfikator Sieć komórkowa Tylko Wi‐Fi Uwagi
hardware_id To pole musi zawierać numer IMEI lub MEID. Rejestracja typu zero-touch weryfikuje format wartości IMEI, gdy przekazujesz je w argumentach interfejsu API. W przypadku urządzeń z więcej niż 1 modemem komórkowym zapoznaj się z sekcją Urządzenia Dual-SIM.
serialNumber Numer seryjny producenta urządzenia. W numerze seryjnym rozróżniana jest wielkość liter. Jest to ta sama wartość, która jest zwracana z funkcji Build.getSerial().
model Wartość modelu urządzenia musi odpowiadać wartości wbudowanej urządzenia zwróconej z Build.MODEL. Listę wartości dozwolonych dla każdego producenta znajdziesz w dokumentacji nazw modeli.
manufacturer Aby rejestracja typu zero-touch działała w przypadku urządzenia tylko z Wi-Fi, wartość w polu manufacturer musi być zgodna z wbudowaną wartością urządzenia zwracaną z funkcji Build.MANUFACTURER. W przypadku urządzeń komórkowych pole manufacturer jest opcjonalne, ale zalecane, ponieważ ułatwia klientom identyfikację urządzeń. Więcej informacji znajdziesz w informacjach o nazwach producentów.

Jeśli urządzenie nie ma modemu komórkowego, np. tabletu lub magazynu, korzystaj z pola „Tylko Wi-Fi”. W przypadku pozostałych urządzeń wykorzystaj pola komórkowe.

Urządzenia dual SIM

Urządzenie dual SIM ma 2 oddzielne modemy i 2 numery IMEI. Wpisz najniższy numer IMEI, ponieważ rejestracja typu zero-touch działa pewniej z najniższym numerem IMEI.

Urządzenia z ChromeOS

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

Identyfikator Uwagi
serialNumber numer seryjny producenta urządzenia.
model Wartość modelu urządzenia musi odpowiadać wartości wbudowanej urządzenia. Zobacz listę wartości modeli ChromeOS.
chromeOsAttestedDeviceId Identyfikator atestowanego urządzenia. Zapoznaj się z listą zgodnych urządzeń z ChromeOS, aby uzyskać pomoc.

Wskaż urządzenie

Użyj identyfikatora DeviceIdentifier podczas wyszukiwania urządzeń lub zgłaszania do nich praw. Musisz uwzględnić pola wymagane w przypadku danego typu urządzenia.

Ten fragment kodu zawiera numer IMEI, który służy do wyszukiwania konkretnego urządzenia przez połączenie się z numerem 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 obejmujący tylko sieć Wi‐Fi:

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