Tham chiếu công ty
Xác định duy nhất một công ty.
| Tên trường | Loại dữ liệu | Mô tả |
|---|---|---|
companyId |
string |
Chỉ đầu ra. Mã nhận dạng của công ty, do máy chủ chỉ định. |
vendor |
enum |
Samsung hoặc Google. |
Công ty
Đại diện cho một công ty.
| Tên trường | Loại dữ liệu | Mô tả |
|---|---|---|
companyReference |
object(CompanyReference) |
Đối tượng tham chiếu của công ty. |
companyName |
string |
Tên của công ty. Ví dụ: XYZ Corp. Hiển thị cho nhân viên của công ty trong cổng đăng ký thiết lập tự động. |
vendorParams |
map |
Các trường bổ sung trong cặp khóa-giá trị do nhà cung cấp chỉ định. |
Thiết bị
Thiết bị Android đã đăng ký để đăng ký.
| Tên trường | Loại dữ liệu | Mô tả |
|---|---|---|
deviceId |
string |
Chỉ đầu ra. Mã của thiết bị, do máy chủ chỉ định. |
deviceIdentifier |
object(DeviceIdentifier) |
Mã phần cứng giúp xác định một thiết bị đã được sản xuất. |
customer |
object(CompanyReference) |
Mã công ty xác định công ty mà thiết bị được chỉ định. |
orderNumber |
string |
Số đơn đặt hàng. |
vendorParams |
map |
Các trường bổ sung trong cặp khóa-giá trị do nhà cung cấp chỉ định. |
Mã nhận dạng thiết bị
Đóng gói phần cứng và mã sản phẩm để xác định thiết bị của nhà sản xuất.
Thiết bị Samsung yêu cầu một trong các trường sau:
IMEIserialNumbermeid
Tất cả các trường khác, chẳng hạn như model, đều bị bỏ qua.
Đối với tất cả các thiết bị Android khác:
- Thiết bị di động yêu cầu
imeivàmanufacturer. - Thiết bị chỉ dùng Wi-Fi yêu cầu
serialNumber,manufacturervàmodel.
| Tên trường | Loại dữ liệu | Mô tả |
|---|---|---|
imei |
string |
Số IMEI của thiết bị. Đã xác thực khi nhập. |
serialNumber |
string |
Số sê-ri của nhà sản xuất thiết bị. Giá trị này có thể không phải là duy nhất trên các mẫu thiết bị khác nhau. |
meid |
string |
Số IMEI của thiết bị. |
manufacturer |
string |
Tên của nhà sản xuất thiết bị. Khớp với giá trị tích hợp sẵn của thiết bị được trả về từ android.os.Build.MANUFACTURER. Các giá trị được phép được liệt kê trong manufacturers. |
model |
string |
Tên mẫu thiết bị. Khớp với giá trị tích hợp sẵn của thiết bị được trả về từ android.os.Build.MODEL. Các giá trị được phép sẽ được liệt kê trong phần mô hình. |
Hoạt động
Tài nguyên này chứa trạng thái của lệnh gọi API không đồng bộ. Có 4 trạng thái:
IN_PROGRESS: Hoạt động này đang diễn ra.COMPLETE: Tất cả thiết bị đã được xử lý thành công.COMPLETE_WITH_ERRORS: Đã xử lý thao tác nhưng đã xảy ra một số lỗi. Tất cả lỗi được liệt kê trong danh sáchdeviceErrors.FAILED: Thao tác không thành công và không trả vềoperationId.
| Tên trường | Loại dữ liệu | Mô tả |
|---|---|---|
operationId |
string |
Mã thao tác có tiền tố là samsung/ hoặc google/. Nếu trống,state sẽ là FAILED. |
operationType |
enum(operationType) |
Loại thao tác: CLAIM_DEVICES hoặc UNCLAIM_DEVICES. |
state |
enum(operationState) |
Trạng thái hoạt động: IN_PROGRESS, COMPLETE, COMPLETE_WITH_ERRORS, FAILED. |
deviceErrors |
Danh sách object(DeviceOperationError) |
Danh sách lỗi hoạt động của thiết bị. |
vendorParams |
map |
Các trường bổ sung trong cặp khóa-giá trị do nhà cung cấp chỉ định. |
Lỗi hoạt động của thiết bị
Lỗi dành riêng cho thiết bị trong Operation. Mỗi tài nguyên chứa cùng một deviceId và deviceIdentifier như yêu cầu bắt đầu hoạt động.
| Tên trường | Loại dữ liệu | Mô tả |
|---|---|---|
deviceId |
string |
Chỉ đầu ra. Mã của thiết bị, do máy chủ chỉ định. |
deviceIdentifier |
object(DeviceIdentifier) |
Mã phần cứng giúp xác định một thiết bị đã được sản xuất. |
error |
object(Error) |
Lỗi hoạt động của thiết bị. |
Trường hợp ngoại lệ phổ biến
Một ngoại lệ có thể được gửi bởi tất cả các API đồng bộ.
| Tên tài sản | Giá trị | Mô tả |
|---|---|---|
error |
object(Error) |
Lỗi thao tác đồng bộ. |
Lỗi
Đối tượng chứa thông tin chi tiết về một lỗi.
| Tên tài sản | Giá trị | Mô tả |
|---|---|---|
code |
enum(ErrorCode) |
Mã lỗi. Ví dụ: INVALID_REQUESET hoặc PERMISSION_DENIED |
message |
string |
Thông báo lỗi. |
vendorMsg |
string |
Thông tin giải thích chi tiết về lỗi do nhà cung cấp. |
errorId |
string |
Giá trị nhận dạng lỗi nội bộ. |
vendorParams |
map |
Các trường bổ sung trong cặp khóa-giá trị do nhà cung cấp chỉ định. |
Mã lỗi
Lỗi phổ biến.
| Enum | Mô tả |
|---|---|
INVALID_PARAM_DEFAULT |
Tham số đầu vào không hợp lệ chưa được chỉ định. Xem nhà cung cấp ứng dụng Authenticator để biết thêm thông tin chi tiết. |
INVALID_PAGE_TOKEN |
PageToken đã được cung cấp không hợp lệ. |
INVALID_CUSTOMER_ID |
Mã khách hàng mà bạn cung cấp không hợp lệ. |
INVALID_DEVICE_IMEI |
Số IMEI không hợp lệ. |
INVALID_DEVICE_MEID |
IMEI không hợp lệ. |
INVALID_DEVICE_SERIAL |
Số sê-ri không hợp lệ. |
INVALID_OPERATION_ID |
Mã điều hành được cung cấp không hợp lệ. |
INVALID_RESELLER_ID |
Id người bán lại được cung cấp không hợp lệ. |
INVALID_MANUFACTURER |
Nhà sản xuất đã cung cấp không hợp lệ / không được hỗ trợ. |
INVALID_IDENTIFIER_SET |
Tập hợp giá trị nhận dạng được cung cấp là không đủ cho yêu cầu này. Xem DeviceIdentifier để biết thêm thông tin về các bộ nhận dạng được cho phép. |
INVALID_MODEL |
Mô hình được cung cấp không hợp lệ / không được hỗ trợ. |
INVALID_DEVICE_ID |
Mã thiết bị mà bạn cung cấp không hợp lệ. |
INVALID_DEVICE |
Thiết bị mà bạn cung cấp không tồn tại. Đây là mã lỗi cụ thể của Samsung. |
DUPLICATE_DEVICE |
Thiết bị này từng được xác nhận quyền sở hữu cho cùng một khách hàng. Bạn không cần làm gì cả. |
DEVICE_UPLOAD_COUNT_EXCEEDED |
Yêu cầu này chứa nhiều thiết bị có giới hạn hơn (hiện là 100 nghìn). |
AUTHORIZATION_FAIL |
Bạn không có quyền truy cập vào một tài nguyên nhất định (ví dụ: thiết bị, khách hàng) hoặc tài nguyên không tồn tại. Hãy xem vendorMsg để biết thêm chi tiết. |
INTERNAL_SERVER_ERROR |
Lỗi máy chủ nội bộ không xác định. Xem thông tin của nhà cung cấp để nhận thêm thông tin. Bạn có thể thử gửi lại các yêu cầu này, tùy thuộc vào tính chất của lỗi máy chủ. |
NOT_IMPLEMENTED |
Máy chủ không hỗ trợ phương thức yêu cầu đó. |