REST Resource: partners.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)
    }
  ]
}
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 partners/[PARTNER_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ị. Để tìm hiểu thêm, hãy đọc bài viết Siêu dữ liệu về thiết bị.

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 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.
}
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 OEM (Nhà sản xuất thiết bị gốc) 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,
  "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ã của Khách hàng đã mua thiết bị.

googleWorkspaceCustomerId

string

Mã 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 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

claim

Xác nhận một thiết bị cho khách hàng và thêm thiết bị đó vào quy trình thiết lập tự động.

claimAsync

Xác nhận một loạt thiết bị cho khách hàng theo cách không đồng bộ.

findByIdentifier

Tìm thiết bị theo mã 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

Nhận một thiết bị.

metadata

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

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ý đi kèm với một loạt thiết bị.