REST Resource: customers.devices

Tài nguyên: Thiết bị

Thiết bị Android hoặc Chrome OS đã đăng ký thiết lập tự động.

Biểu diễn dưới dạng JSON 
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ],
  "configuration": string
}
Các trường
deviceId

string (int64 format)

Chỉ đầu ra. Mã nhận dạng 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. Để tìm hiểu thêm, hãy đọc bài viết về Giá trị nhận dạng.
name

string

Chỉ đầu ra. Tên tài nguyên API ở định dạng customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. Do máy chủ chỉ định.
deviceMetadata

object (DeviceMetadata)

Siêu dữ liệu đính kèm với thiết bị. Có cấu trúc dưới dạng cặp khóa-giá trị.
claims[]

object (DeviceClaim)

Chỉ đầu ra. Yêu cầu cấp phép cho một thiết bị. Các thiết bị đã xác nhận quyền sở hữu mà thiết lập tự động sẽ có thông báo xác nhận quyền sở hữu thuộc loại SECTION_TYPE_ZERO_TOUCH. Gọi customers.devices.unclaim để xoá thiết bị khỏi quy trình thiết lập tự động.
configuration

string

Cấu hình áp dụng cho thiết bị ở định dạng customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Giá trị là null nếu thiết bị không áp dụng cấu hì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 một thiết bị đã sản xuất. Để hiểu các yêu cầu về bộ giá trị nhận dạng, hãy đọc bài viết Giá trị nhận dạng.

Biểu diễn dưới dạng JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.
}
Các trường
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.
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 nhà sản xuất Android.
model

string

Tên mẫu thiết bị. Các giá trị được phép được liệt kê trong mô hình Android và mô hình Chrome OS.
deviceType

enum (DeviceType)

Loại thiết bị
chromeOsAttestedDeviceId

string

Giá trị nhận dạng do OEM cung cấp, được thực hiện trong quá trình sản xuất và bán hàng. Chỉ áp dụng cho các thiết bị Chrome OS.
Trường liên kết hardware_id. Mã phần cứng dựa trên mã modem. hardware_id chỉ có thể là một trong những trạng thái sau:
imei

string

Số IMEI của thiết bị. Đã xác thực khi nhập.
meid

string

Số IMEI của thiết bị.

Loại thiết bị

Hệ điều hành của thiết bị.

Enum
DEVICE_TYPE_ANDROID Thiết bị Android
DEVICE_TYPE_CHROME_OS Thiết bị Chrome OS

Thiết bị có siêu dữ liệu

Các mục siêu dữ liệu có thể đính kèm vào Device. Để tìm hiểu thêm, hãy đọc bài viết Siêu dữ liệu của thiết bị.

Biểu diễn dưới dạng JSON 
{
  "entries": {
    string: string,
    ...
  }
}
Các trường
entries

map (key: string, value: string)

Các mục siêu dữ liệu được ghi lại dưới dạng các cặp khóa-giá trị.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Xác nhận quyền sở hữu thiết bị

Bản ghi thiết bị mà một đại lý xác nhận quyền sở hữu cho khách hàng. Các thiết bị đã xác nhận quyền sở hữu mà thiết lập tự động sẽ có thông báo xác nhận quyền sở hữu thuộc loại SECTION_TYPE_ZERO_TOUCH. Để tìm hiểu thêm, hãy đọc bài viết Xác nhận quyền sở hữu thiết bị cho khách hàng.

Biểu diễn dưới dạng JSON 
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "additionalService": enum (AdditionalService)
}
Các trường
sectionType

enum (DeviceProvisioningSectionType)

Chỉ đầu ra. Loại xác nhận quyền sở hữu trên thiết bị.
ownerCompanyId

string (int64 format)

Mã của khách hàng đã mua thiết bị Android.
googleWorkspaceCustomerId

string

Mã của tài khoản Google Workspace sở hữu thiết bị Chrome OS.
additionalService

enum (AdditionalService)

Dịch vụ bổ sung được đăng ký cho thiết bị.

Loại cấp phép thiết bị

Loại mục của bản ghi cấp phép.

Enum
SECTION_TYPE_SIM_LOCK Loại mục về khoá SIM.
SECTION_TYPE_ZERO_TOUCH Loại phần đăng ký thiết lập tự động.

Dịch vụ bổ sung

Dịch vụ bổ sung được đăng ký cho thiết bị.

Enum
DEVICE_PROTECTION Dịch vụ bảo vệ thiết bị, còn được gọi là Android Enterprise Essentials. Để nhận một thiết bị có dịch vụ bảo vệ thiết bị, bạn phải đăng ký với nhóm hợp tác.

Phương pháp

applyConfiguration

 Áp dụng cấu hình cho thiết bị để đăng ký thiết bị tự động.

get

 Lấy thông tin chi tiết về thiết bị.

list

 Liệt kê các thiết bị của khách hàng.

removeConfiguration

 Xóa cấu hình khỏi thiết bị.

unclaim

 Huỷ xác nhận quyền sở hữu đối với thiết bị của khách hàng và xoá thiết bị đó khỏi thiết lập tự động.