Đối tượng

CompanyReference

Xác định danh tính duy nhất cho một công ty.

Tên trường Loại dữ liệu Mô tả
companyId string Chỉ có đầu ra. Mã của công ty, do máy chủ chỉ định.
vendor enum Samsung hoặc Google.

Công ty

Đại diện cho công ty.

Tên trường Loại dữ liệu Mô tả
companyReference object(CompanyReference) Đối tượng tham chiếu 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 thiết lập tự động.
vendorParams map Trường bổ sung trong các cặp khoá-giá trị do nhà cung cấp chỉ định.

Thiết bị

Một thiết bị Android đã đăng ký.

Tên trường Loại dữ liệu Mô tả
deviceId string Chỉ có đầu ra. Mã của thiết bị do máy chủ chỉ định.
deviceIdentifier object(DeviceIdentifier) Mã phần cứng xác định một thiết bị được sản xuất.
customer object(CompanyReference) Mã công ty giúp xác định thiết bị được chỉ định cho công ty nào.
orderNumber string Số đơn đặt hàng.
vendorParams map Các trường bổ sung trong các cặp khoá-giá trị do nhà cung cấp chỉ định.

DeviceIdentifier

Đóng gói mã phần cứng và mã sản phẩm để nhận dạng 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:

  • IMEI
  • serialNumber
  • meid

Tất cả các trường khác, chẳng hạn như model, sẽ bị bỏ qua.

Đối với tất cả các thiết bị Android khác:

  • Thiết bị di động cần có imei và manufacturer.
  • Các thiết bị chỉ có Wi-Fi yêu cầu serialNumber, manufacturer và 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à riêng biệt trên các mẫu thiết bị.
meid string Số MEID 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 của thiết bị được trả về từ android.os.Build.MANUFACTURER. Bạn có thể xem các giá trị được phép trong nhà sản xuất.
model string Tên mẫu thiết bị. Khớp với giá trị tích hợp của thiết bị được trả về từ android.os.Build.MODEL. Các giá trị được phép được liệt kê trong 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ó bốn trạng thái có thể có:

  • IN_PROGRESS: Thao tác đang diễn ra.
  • COMPLETE: Tất cả các thiết bị đã được xử lý thành công.
  • COMPLETE_WITH_ERRORS: Thao tác đã được xử lý nhưng đã xảy ra một số lỗi. Tất cả lỗi được liệt kê trong danh sách deviceErrors.
  • FAILED: Thao tác không thành công và không có operationId nào được trả về.
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 toán tử: 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 các lỗi thao tác với thiết bị.
vendorParams map Các trường bổ sung trong các cặp khoá-giá trị do nhà cung cấp chỉ định.

DeviceOperationError

Một lỗi cụ thể theo thiết bị trong Operation. Mỗi tài nguyên chứa cùng một deviceId và deviceIdentifier làm yêu cầu đã bắt đầu thao tác.

Tên trường Loại dữ liệu Mô tả
deviceId string Chỉ có đầu ra. Mã của thiết bị do máy chủ chỉ định.
deviceIdentifier object(DeviceIdentifier) Mã phần cứng 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ị.

CommonException

Tất cả các API đồng bộ đều có thể gửi một trường hợp ngoại lệ.

Tên tài sản Giá trị Mô tả
error object(Error) Lỗi hoạt động đồ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 của 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ác cặp khoá-giá trị do nhà cung cấp chỉ định.

ErrorCode

Lỗi thường gặp.

Enum Mô tả
INVALID_PARAM_DEFAULT Tham số đầu vào không hợp lệ không xác định. Hãy xem thông báo của ProviderTin nhắn của nhà cung cấp để biết thêm thông tin.
INVALID_PAGE_TOKEN Mã trang bạn cung cấp là không hợp lệ.
INVALID_CUSTOMER_ID Mã khách hàng được cung cấp không hợp lệ.
INVALID_DEVICE_IMEI Số IMEI không hợp lệ.
INVALID_DEVICE_MEID MEID không hợp lệ.
INVALID_DEVICE_SERIAL Số sê-ri không hợp lệ.
INVALID_OPERATION_ID Toán tử được cung cấp không hợp lệ.
INVALID_RESELLER_ID Mã đại lý bạn cung cấp không hợp lệ.
INVALID_MANUFACTURER Nhà sản xuất đã cung cấp là không hợp lệ / không được hỗ trợ.
INVALID_IDENTIFIER_SET Bộ giá trị nhận dạng được cung cấp là không đủ cho yêu cầu. Xem DeviceIdentifier để biết thêm thông tin về các nhóm giá trị nhận dạng được 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ị được cung cấp không hợp lệ.
INVALID_DEVICE Thiết bị được cung cấp không tồn tại. Đây là mã lỗi của riêng Samsung.
DUPLICATE_DEVICE Thiết bị này từng được một khách hàng xác nhận quyền sở hữu. Bạn không cần phải khắc phục.
DEVICE_UPLOAD_COUNT_EXCEEDED Yêu cầu chứa nhiều thiết bị hơn giới 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. Hãy xem thư của nhà cung cấp để biết thêm thông tin. Bạn có thể thử lại các yêu cầu này tuỳ theo 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 này.