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
- Więcej informacji o identyfikatorach sprzętowych znajdziesz w dokumentacji referencyjnej interfejsu API
DeviceIdentifier
. - Listę dozwolonych nazw producentów i modeli urządzeń znajdziesz w informacjach o nazwach producentów.
- Listę zgodnych urządzeń z ChromeOS znajdziesz w Centrum pomocy ChromeOS.