Identyfikatory

DeviceIdentifier zawiera identyfikatory sprzętowe, aby zidentyfikować producenta urządzenia. Z tego dokumentu dowiesz się, jak korzystać z identyfikatorów w API rejestracji typu zero-touch.

Element DeviceIdentifier łączy metadane sprzętowe lub identyfikatory wymagane do jednoznacznego identyfikować urządzenie.

Podczas przesyłania urządzenia Twoja organizacja uwzględnia wartości identyfikatorów urządzeń w portalu lub przez wywoływanie interfejsu API. Ponieważ DeviceIdentifier instancji są stałe, nie można 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 numeru IMEI (MEID) identyfikatory modemów komórkowych. W przypadku urządzeń bez modemu komórkowego, takich jak na tabletach, możesz też identyfikować urządzenia, korzystając z innego zestawu pól. w poniższej tabeli znajdują się pola wymagane 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 typu zero-touch weryfikuje format wartości IMEI przekazywanych w argumentach interfejsu API. Informacje o urządzeniach z więcej niż jednym modemem komórkowym znajdziesz w artykule Urządzenia z 2 kartami SIM.
serialNumber Numer seryjny producenta urządzenia. Wielkość liter w numerze seryjnym ma znaczenie. Jest to ta sama wartość, która jest zwracana przez Build.getSerial().
model Wartość modelu urządzenia musi odpowiadać wartości wbudowanej zwracanej przez Build.MODEL. Listę wartości dozwolonych w przypadku każdego producenta znajdziesz w informacjach o nazwach modeli.
manufacturer Aby rejestracja typu zero-touch działała w przypadku urządzeń obsługujących tylko Wi-Fi, wartość w polu manufacturer musi odpowiadać wartości wbudowanej urządzenia zwróconej przez Build.MANUFACTURER. W przypadku urządzeń komórkowych pole manufacturer jest opcjonalne, ale zalecane, ponieważ ułatwia klientom ich rozpoznawanie. Więcej informacji znajdziesz w informacjach o nazwach producentów.

Jeśli urządzenie nie ma modemu komórkowego, np. tabletu lub skaner asortymentu w magazynie, użyj pól tylko Wi-Fi. W przypadku wszystkich pozostałych urządzeń korzystać z pól komórkowych.

Urządzenia 2 SIM

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

Urządzenia z ChromeOS

W przypadku urządzeń z ChromeOS zestaw wymaganych identyfikatorów jest taki sam dla sieci komórkowych i urządzenia, które obsługują tylko sieć Wi-Fi:

Identyfikator Uwagi
serialNumber Numer seryjny producenta urządzenia urządzenia.
model Wartość modelu urządzenia musi być zgodna z Google Ads. Zobacz listę wartości modelu ChromeOS. w celach informacyjnych.
chromeOsAttestedDeviceId Identyfikator atestowanego urządzenia. Zobacz listę zgodny ChromeOS urządzeń w przypadku odwołania.

Podaj urządzenie

Użyj DeviceIdentifier przy wyszukiwaniu urządzeń i zgłaszaniu praw do nich. Musisz dodać wymagane pola określone dla typu urządzenia.

Ten fragment zawiera numer IMEI używany do wyszukiwania konkretnego urządzenia aby zadzwonić pod numer 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ć urządzenie, które ma tylko dostęp do sieci Wi‐Fi identyfikator:

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 tutaj Dokumentacja API dotycząca DeviceIdentifier.
  • Aby zobaczyć listę dozwolonych nazw producentów i modeli urządzeń, zapoznaj się z nazwy producentów.
  • Listę zgodnych urządzeń z ChromeOS znajdziesz w Centrum pomocy ChromeOS