Tanımlayıcılar

DeviceIdentifier, üretilmiş bir cihazı tanımlamak için donanım kimliklerini kapsar. Bu dokümanda, el değmeden kayıt API'sinde tanımlayıcılar ile nasıl çalışacağınız açıklanmaktadır.

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

Kuruluşunuz, cihaz verilerini portal üzerinden yüklerken veya API'yi çağırırken cihaz tanımlayıcısı değerlerini içeriyor.

Zorunlu alanlar

Android cihazlar

El değmeden kayıt özelliği, cihazları genellikle IMEI (veya MEID) hücresel modem kimliklerine göre tanımlar. Tabletler gibi hücresel modem içermeyen cihazları desteklemek için farklı bir alan grubu kullanarak cihazları da tanımlayabilirsiniz. Aşağıdaki tabloda, her cihaz türü için kullanabileceğiniz alanlar gösterilmektedir:

Tanımlayıcı Hücresel Yalnızca kablosuz Notlar
hardware_id Bu alan bir IMEI veya MEID numarası olmalıdır. Dokunmatik olmayan kayıt, IMEI değerlerini API bağımsız değişkenlerine ilettiğinizde değerlerin biçimini doğrular.
hardware_id2 Bu alan ikinci bir IMEI veya MEID numarası olmalıdır. Dokunmatik olmayan kayıt, IMEI değerlerini API bağımsız değişkenlerine ilettiğinizde değerlerin biçimini doğrular. Birden fazla hücresel modeme sahip cihazlar hakkında bilgi edinmek için Çift SIM kartlı cihazlar başlıklı makaleyi inceleyin.
serialNumber Üreticinin cihaz için verdiği seri numarası. Seri numarası büyük/küçük harfe duyarlıdır ve Build.getSerial() kaynağından döndürülen değerle aynıdır.
model Cihaz modeli değeri, Build.MODEL kaynağından döndürülen cihazın yerleşik değeriyle eşleşmelidir. Her üretici için izin verilen değerlerin listesi için model adları referansını inceleyin.
manufacturer manufacturer alan değeri, Build.MANUFACTURER kaynağından döndürülen cihazın yerleşik değeriyle eşleşmelidir. Daha fazla bilgi için üretici adları referansına bakın.

Seri numarasını kaydederken, el değmeden kayıt özelliğinin cihazı algılayabilmesi için üreticiyi ve modeli de kaydetmeniz gerekir.

Çift SIM kartlı cihazlar

Çift SIM kartlı cihazlarda iki ayrı modem bulunur ve iki IMEI numarası vardır. Yalnızca bir IMEI kaydediyorsanız el değmeden kayıt özelliği en düşük IMEI ile daha güvenilir çalıştığından sayısal olarak en düşük IMEI numarasını tercih edin. Güvenilirliği artırmak için diğer IMEI'yi veya seri numarasını, üreticiyi ve modeli de kaydedebilirsiniz.

El değmeden kayıt portalında ikinci IMEI'yi görüntülemek için:

  1. Cihazlar sekmesine gidin.
  2. Sağ üst köşedeki Cihaz Ekle düğmesinin yanındaki üç noktayı tıklayın.
  3. Tabloyu özelleştir'i seçin.
  4. IMEI2 onay kutusunu işaretleyin.
  5. Kaydet'i tıklayın.

ChromeOS cihazlar

ChromeOS cihazlarda, gerekli tanımlayıcı grubu hem hücresel hem de yalnızca kablosuz cihazlar için aynıdır:

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

Bir cihaza referans verme

Cihazları bulurken veya cihaz için hak talebinde bulunurken DeviceIdentifier kullanın. Cihaz türü için belirtilen zorunlu alanları eklemeniz gerekir.

Aşağıdaki snippet'te, partners.devices.findByIdentifier çağrısı yapılarak belirli bir cihazı aramak için kullanılan bir 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, seri numarası içeren bir 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 ile ilgili API referans dokümanlarına bakın.
  • İzin verilen üretici adları ve cihaz modellerinin listesini görmek için üretici adları referansını inceleyin.
  • Uyumlu ChromeOS cihazların listesini görmek için ChromeOS Yardım Merkezi'ne bakın.