REST Resource: customers.devices

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

Một 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
}
Trường
deviceId

string (int64 format)

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

name

string

Chỉ có đầ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 đi kèm thiết bị. Có cấu trúc dưới dạng cặp khoá-giá trị.

claims[]

object (DeviceClaim)

Chỉ có đầu ra. Việc cấp phép xác nhận quyền sở hữu đối với một thiết bị. Những thiết bị được xác nhận quyền sở hữu để thiết lập tự động 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 được á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.

DeviceIdentifier

Đó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ề tập hợp 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.
}
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à riêng biệt trên các mẫu 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. 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 kiểu máy Androidkiểu máy ChromeOS.

deviceType

enum (DeviceType)

Loại thiết bị

chromeOsAttestedDeviceId

string

Giá trị nhận dạng do Nhà sản xuất thiết bị gốc (OEM) cung cấp trong quá trình sản xuất và bán hàng. Chỉ áp dụng cho các thiết bị ChromeOS.

Trường kết hợp hardware_id. ID phần cứng dựa trên ID modem. hardware_id chỉ có thể là một trong những trạng thái sau đây:
imei

string

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

meid

string

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

DeviceType

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ị ChromeOS

DeviceMetadata

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 về thiết bị.

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

map (key: string, value: string)

Các mục nhập siêu dữ liệu được ghi lại dưới dạng cặp khoá-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" }.

DeviceClaim

Bản ghi về một thiết bị đã được đại lý xác nhận quyền sở hữu cho một khách hàng. Những thiết bị được xác nhận quyền sở hữu để thiết lập tự động 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 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)
}
Trường
sectionType

enum (DeviceProvisioningSectionType)

Chỉ có đầu ra. Loại thông báo xác nhận quyền sở hữu được đưa ra trên thiết bị.

ownerCompanyId

string (int64 format)

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

googleWorkspaceCustomerId

string

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

additionalService

enum (AdditionalService)

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

DeviceProvisioningSectionType

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

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

AdditionalService

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

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

Phương thức

applyConfiguration

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

get

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

list

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

removeConfiguration

Xoá một 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 quy trình thiết lập tự động.