Tanımlayıcılar

DeviceIdentifier, üretilmiş bir cihazı tanımlamak için gereken donanım kimliklerini kapsüller. Bu belgede, el değmeden kayıt API'sindeki tanımlayıcılarla nasıl çalışabileceğiniz açıklanmaktadır.

DeviceIdentifier, bir cihazı benzersiz şekilde tanımlamak için gereken donanım meta verilerini veya kimlikleri birleştirir.

Kuruluşunuz, portal üzerinden cihaz verileri yüklerken veya API'yi çağırırken cihaz tanımlayıcı değerlerini dahil eder. DeviceIdentifier örnekleri sabit olduğundan, alan değerlerini değiştirmek için API'yi kullanamazsınız.

Zorunlu alanlar

Android cihazlar

El değmeden kayıt, cihazları genellikle IMEI (veya MEID) hücresel modem kimliklerine göre tanımlar. Ancak hücresel modem'i olmayan cihazları (ör. tabletler) desteklemek için farklı alan grupları kullanarak cihazları da tanımlayabilirsiniz. Aşağıdaki tabloda, her cihaz türü için gerekli alanlar gösterilmektedir:

Tanımlayıcı Hücresel Yalnızca kablosuz Notlar
hardware_id Bu alan bir IMEI veya MEID numarası olmalıdır. El değmeden kayıt, API bağımsız değişkenlerinde ilettiğiniz IMEI değerlerinin biçimini doğrular. Birden fazla hücresel modemi olan cihazlar için Çift SIM kartlı cihazlar başlıklı makaleyi inceleyin.
serialNumber Cihazın üreticinin seri numarası. Seri numarası büyük/küçük harfe duyarlıdır ve Build.getSerial() öğesinden döndürülen değerle aynıdır.
model Cihaz modeli değeri, cihazın Build.MODEL üzerinden döndürülen yerleşik değeriyle eşleşmelidir. Her üreticide izin verilen değerlerin listesini görmek için model adları referansına bakın.
manufacturer El değmeden kayıt özelliğinin yalnızca kablosuz ağa bağlı cihazlarda çalışması için manufacturer alanındaki değerin, cihazın Build.MANUFACTURER üzerinden döndürülen yerleşik değeriyle eşleşmesi gerekir. Hücresel cihazlar için manufacturer alanı isteğe bağlıdır ancak müşterilerin cihazlarını daha kolay tanımasını sağladığı için önerilir. Daha fazla bilgi için üretici adları referansına bakın.

Cihazda hücresel modem (ör. tablet veya depo envanter tarayıcısı) yoksa Yalnızca kablosuz ağ alanlarını kullanın. Diğer tüm cihazlar için hücresel alanları kullanın.

Çift SIM kartlı cihazlar

Çift SIM kartlı cihazlarda iki ayrı modem bulunur ve iki IMEI numarası vardır. El değmeden kayıt, en düşük IMEI numarasıyla daha güvenilir şekilde çalıştığından sayısal olarak en düşük IMEI numarasını kullanın.

ChromeOS cihazlar

ChromeOS cihazlarda zorunlu tanımlayıcılar grubu, yalnızca hücresel ve kablosuz ağ üzerinden bağlanan cihazlar için aynıdır:

Tanımlayıcı Notlar
serialNumber Üreticinin seri numarası.
model Cihaz modeli değeri, cihazın yerleşik değeriyle eşleşmelidir. Referans için ChromeOS model değerleri listesine bakın.
chromeOsAttestedDeviceId Onaylı Cihaz Kimliği. Referans için uyumlu ChromeOS cihazların listesine bakın.

Bir cihaza bakın

Cihaz bulurken veya talep ederken DeviceIdentifier kullanın. Cihaz türü için belirtilen zorunlu alanları eklemeniz gerekir.

Aşağıdaki snippet'te partners.devices.findByIdentifier numaralı telefonu arayarak belirli bir cihazı aramak için kullanılan IMEI numarası gösterilmektedir:

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()

Aşağıdaki snippet'te yalnızca kablosuz ağ cihaz tanımlayıcısının nasıl oluşturulacağı gösterilmektedir:

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

Daha fazla bilgi

  • Donanım tanımlayıcıları hakkında daha fazla bilgi edinmek için DeviceIdentifier API referans belgelerine bakın.
  • İzin verilen üretici adlarının ve cihaz modellerinin listesini görmek için üretici adları referansını inceleyin.
  • Uyumlu ChromeOS cihazların listesini görmek için ChromeO Yardım Merkezi'ne göz atın.