REST Resource: partners.devices

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

Một thiết bị Android hoặc Chrome OS đã đăng ký sử dụng tính năng 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)
    }
  ]
}
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 partners/[PARTNER_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ị. Để tìm hiểu thêm, hãy đọc bài viết Siêu dữ liệu thiết bị.
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 partners.devices.unclaim hoặc partners.devices.unclaimAsync để xoá thiết bị khỏi quy trình thiết lập tự động.

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à 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ị. 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 phần Nhà sản xuất Android.
model

string

Tên của mẫu thiết bị. Các giá trị được phép được liệt kê trong các mẫu Android và các mẫu Chrome OS.
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 thiết bị Chrome OS.
Trường hợp hợp nhất 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 hợp hợp nhất 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 có cùng 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ể được đính kèm vào Device. Để tìm hiểu thêm, hãy đọc bài viết Siêu dữ liệu 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 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,
  "resellerId": 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.
resellerId

string (int64 format)

Mã của đại lý đã xác nhận quyền sở hữu thiết bị.
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 mục khoá SIM.
SECTION_TYPE_ZERO_TOUCH Loại phần thiết lập tự động.

AdditionalService

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 gọi là Android Enterprise Essentials. Để xác nhận quyền sở hữu 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 đối tác.

Phương thức

claim

 Xác nhận quyền sở hữu thiết bị cho khách hàng và thêm thiết bị đó vào quy trình đăng ký không tiếp xúc.

claimAsync

 Xác nhận quyền sở hữu một lô thiết bị cho khách hàng theo cách không đồng bộ.

findByIdentifier

 Tìm thiết bị theo giá trị nhận dạng phần cứng, chẳng hạn như IMEI.

findByOwner

 Tìm thiết bị đã được xác nhận quyền sở hữu cho khách hàng.

get

 Lấy một thiết bị.

metadata

 Cập nhật siêu dữ liệu của đại lý liên kết vớ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.

unclaimAsync

 Huỷ xác nhận quyền sở hữu một loạt thiết bị cho khách hàng theo cách không đồng bộ.

updateMetadataAsync

 Cập nhật siêu dữ liệu của đại lý được đính kèm vào một lô thiết bị.