REST Resource: customers.devices

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

Một thiết bị Android hoặc Chrome OS đã đăng ký quy trình 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ã nhận dạng phần cứng giúp xác định một thiết bị đã 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 được đính kèm vào thiết bị. Được cấu trúc dưới dạng cặp khoá-giá trị.
claims[]

object (DeviceClaim)

Chỉ có đầu ra. Các thông báo xác nhận quyền cấp phép cho một thiết bị. Những thiết bị được xác nhận quyền sở hữu để đăng ký không cần chạm 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 đượ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.

  // Union field hardware_id2 can be only one of the following:
  "imei2": string,
  "meid2": string
  // End of list of possible types for union field hardware_id2.
}
Trường
serialNumber

string

Số sê-ri của nhà sản xuất cho thiết bị. Giá trị này có thể không phải là giá trị duy nhất trên các mẫu thiết bị.
manufacturer

string

Tên của nhà sản xuất thiết bị. So 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 Android và kiể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, đượ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ị ChromeOS.
Trường kết hợp hardware_id. Mã nhận dạng phần cứng dựa trên mã nhận dạng 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ị.
Trường kết hợp hardware_id2. Mã nhận dạng phần cứng thứ hai, dành cho thiết bị có hai SIM. Nếu được đặt, mã này phải thuộc cùng một loại giá trị nhận dạng với mã phần cứng đầu tiên. hardware_id2 chỉ có thể là một trong những giá trị sau:
imei2

string

Số IMEI thứ hai của thiết bị.
meid2

string

Số MEID thứ hai 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ị mà đại lý xác nhận quyền sở hữu cho khách hàng. Những thiết bị được xác nhận quyền sở hữu để đăng ký không cần chạm 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 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ã nhận dạng của Khách hàng đã mua thiết bị.
googleWorkspaceCustomerId

string

Mã nhận dạng của 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 phần 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 được gọi là Android Enterprise Essentials. Để xác nhận quyền sở hữu thiết bị có 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 Cấu hình cho thiết bị để đăng ký thiết bị cho tính năng thiết lập tự động.

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 thiết bị của khách hàng và xoá thiết bị đó khỏi quy trình đăng ký không tiếp xúc.