Nesneler

ŞirketReferansı

Bir şirketi benzersiz bir şekilde tanımlar.

Alan adı Veri türü Açıklama
companyId string Yalnızca çıkış. Sunucu tarafından atanan şirketin kimliği.
vendor enum Samsung veya Google.

Şirket

Bir şirketi temsil eder.

Alan adı Veri türü Açıklama
companyReference object(CompanyReference) Şirket referans nesnesi.
companyName string Şirketin adı. Örneğin, XYZ Corp. El değmeden kayıt portalında şirket çalışanlarına gösterilir.
vendorParams map Tedarikçi firma tarafından belirtilen anahtar/değer çiftlerindeki ekstra alanlardır.

Cihaz

Kayıt için kaydedilmiş bir Android cihaz.

Alan adı Veri türü Açıklama
deviceId string Yalnızca çıkış. Sunucu tarafından atanan cihazın kimliği.
deviceIdentifier object(DeviceIdentifier) Üretilmiş bir cihazı tanımlayan donanım kimlikleri.
customer object(CompanyReference) Cihazların atandığı şirketi tanımlayan şirket kimlikleri.
orderNumber string Sipariş numarası.
vendorParams map Tedarikçi firma tarafından belirtilen anahtar/değer çiftlerindeki ekstra alanlardır.

DeviceIdentifier

Üreticinin cihazını tanımlamak için donanım ve ürün kimliklerini içerir.

Samsung cihazlar aşağıdaki alanlardan birini gerektirir:

  • IMEI
  • serialNumber
  • meid

model gibi diğer tüm alanlar yok sayılır.

Diğer tüm Android cihazlar için:

  • Hücresel cihazlar için imei ve manufacturer gereklidir.
  • Yalnızca kablosuz cihazlar için serialNumber, manufacturer ve model gerekir.
Alan adı Veri türü Açıklama
imei string Cihazın IMEI numarası. Girişte doğrulandı.
serialNumber string Cihaz için üreticinin seri numarası. Bu değer, farklı cihaz modelleri arasında benzersiz olmayabilir.
meid string Cihazın MEID numarası.
manufacturer string Cihaz üreticisinin adı. Cihazın android.os.Build.MANUFACTURER işlevinden döndürülen yerleşik değeriyle eşleşir. İzin verilen değerler üreticiler bölümünde listelenir.
model string Cihaz modelinin adı. Cihazın android.os.Build.MODEL işlevinden döndürülen yerleşik değeriyle eşleşir. İzin verilen değerler modellerde listelenir.

İşlem

Bu kaynak, eşzamansız bir API çağrısının durumunu içerir. Dört olası durum söz konusudur:

  • IN_PROGRESS: İşlem devam ediyor.
  • COMPLETE: Tüm cihazlar başarıyla işlendi.
  • COMPLETE_WITH_ERRORS: İşlem işlendi ancak bazı hatalar oluştu. Tüm hatalar deviceErrors listesindedir.
  • FAILED: İşlem başarısız oldu ve operationId döndürülmedi.
Alan adı Veri türü Açıklama
operationId string İşlem kimliği, ön ek olarak samsung/ veya google/. Boşsa state, FAILED şeklindedir.
operationType enum(operationType) İşlem türü: CLAIM_DEVICES veya UNCLAIM_DEVICES.
state enum(operationState) İşlem durumu: IN_PROGRESS, COMPLETE, COMPLETE_WITH_ERRORS, FAILED.
deviceErrors object(DeviceOperationError) listesi Cihaz işlem hatalarının listesi.
vendorParams map Tedarikçi firma tarafından belirtilen anahtar/değer çiftlerindeki ekstra alanlardır.

Cihazİşlem Hatası

Operation içindeki cihaza özel bir hata. Her kaynak, işlemi başlatan istekle aynı deviceId ve deviceIdentifier değerlerini içerir.

Alan adı Veri türü Açıklama
deviceId string Yalnızca çıkış. Sunucu tarafından atanan cihazın kimliği.
deviceIdentifier object(DeviceIdentifier) Üretilmiş bir cihazı tanımlayan donanım kimlikleri.
error object(Error) Cihaz işlem hatası.

İstisna

Eşzamanlı tüm API'lerin atabileceği bir istisnadır.

Mülk adı Değer Açıklama
error object(Error) Eşzamanlı işlem hatası.

Hata

Hatayla ilgili ayrıntıları içeren bir nesne.

Mülk adı Değer Açıklama
code enum(ErrorCode) Hata kodu. Örneğin, INVALID_REQUESET veya PERMISSION_DENIED
message string Hata mesajı.
vendorMsg string Sağlayıcıdan gelen hatanın ayrıntılı açıklaması.
errorId string Dahili hata tanımlayıcısı.
vendorParams map Tedarikçi firma tarafından belirtilen anahtar/değer çiftlerindeki ekstra alanlardır.

ErrorCode

Sık karşılaşılan hatalar.

Enum Açıklama
INVALID_PARAM_DEFAULT Belirtilmemiş geçersiz giriş parametresi. Daha fazla bilgi edinmek için sellersMsg'ye bakın.
INVALID_PAGE_TOKEN Sağlanan pageToken geçersiz.
INVALID_CUSTOMER_ID Sağlanan müşteri kimliği geçersiz.
INVALID_DEVICE_IMEI Geçersiz IMEI.
INVALID_DEVICE_MEID Geçersiz MEID.
INVALID_DEVICE_SERIAL Geçersiz seri numarası.
INVALID_OPERATION_ID Sağlanan işlem kimliği geçersiz.
INVALID_RESELLER_ID Sağlanan bayi kimliği geçersiz.
INVALID_MANUFACTURER Sağlanan üretici geçersiz / desteklenmiyor.
INVALID_IDENTIFIER_SET Sağlanan kimlik grubu istek için yeterli değil. İzin verilen tanımlayıcı grupları hakkında daha fazla bilgi için DeviceIdentifier konusuna bakın.
INVALID_MODEL Sağlanan model geçersiz / desteklenmiyor.
INVALID_DEVICE_ID Sağlanan deviceId geçersiz.
INVALID_DEVICE Sağlanan cihaz mevcut değil. Bu, Samsung'a özel bir hata kodudur.
DUPLICATE_DEVICE Cihaz için daha önce aynı müşteriyle ilgili hak talebinde bulunuldu. Düzeltici işlem yapmanız gerekmez.
DEVICE_UPLOAD_COUNT_EXCEEDED İstek, izin verilen sayıda cihaz (şu anda 100 bin) içeriyor.
AUTHORIZATION_FAIL Belirli bir kaynağa (ör. cihaz, müşteri) erişiminiz yok veya kaynak mevcut değil. Daha ayrıntılı bilgi için vendorMsg sayfasına bakın.
INTERNAL_SERVER_ERROR Belirtilmemiş dahili sunucu hatası. Daha fazla bilgi edinmek için providerMsg'ye bakın. Bu istekler, sunucu hatasının yapısına bağlı olarak yeniden denenebilir.
NOT_IMPLEMENTED İstek yöntemi sunucu tarafından desteklenmiyor.