Objek

Referensi Perusahaan

Mengidentifikasi perusahaan secara unik.

Nama kolom Jenis data Deskripsi
companyId string Hanya output. ID perusahaan, yang ditetapkan oleh server.
vendor enum Samsung atau Google.

Perusahaan

Mewakili perusahaan.

Nama kolom Jenis data Deskripsi
companyReference object(CompanyReference) Objek referensi perusahaan.
companyName string Nama perusahaan. Misalnya XYZ Corp. Ditampilkan kepada karyawan perusahaan di portal pendaftaran zero-touch.
vendorParams map Kolom tambahan dalam key-value pair yang ditentukan vendor.

Perangkat

Perangkat Android yang terdaftar untuk pendaftaran.

Nama kolom Jenis data Deskripsi
deviceId string Hanya output. ID perangkat, yang ditetapkan oleh server.
deviceIdentifier object(DeviceIdentifier) ID hardware yang mengidentifikasi perangkat produsen.
customer object(CompanyReference) ID perusahaan yang mengidentifikasi perusahaan mana yang ditetapkan ke perangkat.
orderNumber string Nomor pesanan.
vendorParams map Kolom tambahan dalam key-value pair yang ditentukan vendor.

DeviceIdentifier

Mengenkapsulasi ID hardware dan produk untuk mengidentifikasi perangkat produsen.

Perangkat Samsung memerlukan salah satu kolom berikut:

  • IMEI
  • serialNumber
  • meid

Semua kolom lainnya, seperti model, akan diabaikan.

Untuk semua perangkat Android lainnya:

  • Perangkat seluler memerlukan imei dan manufacturer.
  • Perangkat khusus Wi-Fi memerlukan serialNumber, manufacturer, dan model.
Nama kolom Jenis data Deskripsi
imei string Nomor IMEI perangkat. Divalidasi pada input.
serialNumber string Nomor seri produsen untuk perangkat. Nilai ini mungkin tidak unik untuk berbagai model perangkat.
meid string Nomor MEID perangkat.
manufacturer string Nama produsen perangkat. Cocok dengan nilai bawaan perangkat yang ditampilkan dari android.os.Build.MANUFACTURER. Nilai yang diizinkan tercantum dalam produsen.
model string Nama model perangkat. Cocok dengan nilai bawaan perangkat yang ditampilkan dari android.os.Build.MODEL. Nilai yang diizinkan tercantum dalam model.

Operasi

Resource ini berisi status panggilan API asinkron. Ada empat kemungkinan status:

  • IN_PROGRESS: Operasi sedang berlangsung.
  • COMPLETE: Semua perangkat berhasil diproses.
  • COMPLETE_WITH_ERRORS: Operasi telah diproses, tetapi terjadi beberapa error. Semua error tercantum dalam daftar deviceErrors.
  • FAILED: Operasi gagal dan tidak ada operationId yang ditampilkan.
Nama kolom Jenis data Deskripsi
operationId string ID operasi, yang diawali dengan samsung/ atau google/. Jika kosong,state adalah FAILED.
operationType enum(operationType) Jenis operasi: CLAIM_DEVICES atau UNCLAIM_DEVICES.
state enum(operationState) Status operasi: IN_PROGRESS, COMPLETE, COMPLETE_WITH_ERRORS, FAILED.
deviceErrors Daftar object(DeviceOperationError) Daftar error operasi perangkat.
vendorParams map Kolom tambahan dalam key-value pair yang ditentukan vendor.

ErrorPerangkatPerangkat

Error khusus perangkat di Operation. Setiap resource berisi deviceId dan deviceIdentifier yang sama dengan permintaan yang memulai operasi.

Nama kolom Jenis data Deskripsi
deviceId string Hanya output. ID perangkat, yang ditetapkan oleh server.
deviceIdentifier object(DeviceIdentifier) ID hardware yang mengidentifikasi perangkat produsen.
error object(Error) Error operasi perangkat.

Umum

Pengecualian yang dapat ditampilkan oleh semua API sinkron.

Nama properti Nilai Deskripsi
error object(Error) Error operasi sinkron.

Error

Objek yang berisi detail tentang error.

Nama properti Nilai Deskripsi
code enum(ErrorCode) Kode error. Misalnya, INVALID_REQUESET atau PERMISSION_DENIED
message string Pesan error.
vendorMsg string Penjelasan mendetail tentang error dari vendor.
errorId string ID error internal.
vendorParams map Kolom tambahan dalam key-value pair yang ditentukan vendor.

ErrorCode

Error umum.

Enum Deskripsi
INVALID_PARAM_DEFAULT Parameter input tidak valid tidak ditentukan. Lihat vendormsg untuk mendapatkan detail selengkapnya.
INVALID_PAGE_TOKEN PageToken yang diberikan tidak valid.
INVALID_CUSTOMER_ID customerId yang diberikan tidak valid.
INVALID_DEVICE_IMEI IMEI tidak valid.
INVALID_DEVICE_MEID MEID tidak valid.
INVALID_DEVICE_SERIAL Nomor Seri Tidak Valid.
INVALID_OPERATION_ID OperationsId yang diberikan tidak valid.
INVALID_RESELLER_ID ID reseller yang disediakan tidak valid.
INVALID_MANUFACTURER Produsen yang diberikan tidak valid / tidak didukung.
INVALID_IDENTIFIER_SET Kumpulan ID yang diberikan tidak memadai untuk permintaan. Lihat DeviceIdentifier untuk mengetahui informasi selengkapnya tentang kumpulan ID yang diizinkan.
INVALID_MODEL Model yang diberikan tidak valid / tidak didukung.
INVALID_DEVICE_ID deviceId yang diberikan tidak valid.
INVALID_DEVICE Perangkat yang diberikan tidak ada. Ini adalah kode error khusus Samsung.
DUPLICATE_DEVICE Perangkat sebelumnya telah diklaim ke pelanggan yang sama. Tidak perlu tindakan perbaikan.
DEVICE_UPLOAD_COUNT_EXCEEDED Permintaan berisi lebih banyak perangkat dengan batas tersebut (saat ini 100 ribu).
AUTHORIZATION_FAIL Anda tidak memiliki akses ke resource tertentu (misalnya perangkat, pelanggan), atau resource tidak ada. Lihat vendorMsg untuk mendapatkan detail selengkapnya.
INTERNAL_SERVER_ERROR Error server internal tidak ditentukan. Lihat vendormsg untuk mendapatkan detail selengkapnya. Permintaan ini dapat dicoba kembali, bergantung pada sifat error server.
NOT_IMPLEMENTED Metode permintaan tidak didukung oleh server.