Ş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
vemanufacturer
gereklidir. - Yalnızca kablosuz cihazlar için
serialNumber
,manufacturer
vemodel
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 hatalardeviceErrors
listesindedir.FAILED
: İşlem başarısız oldu veoperationId
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. |