Method: partners.devices.claim

Nhận một thiết bị cho khách hàng và thêm thiết bị đó vào chương trình thiết lập tự động. Nếu khách hàng khác đã xác nhận quyền sở hữu thiết bị này, thì cuộc gọi sẽ trả về lỗi.

Yêu cầu HTTP

POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
partnerId

string (int64 format)

Bắt buộc. Mã của đối tác đại lý.

Nội dung yêu cầu

Phần nội dung yêu cầu chứa dữ liệu có cấu trúc như sau:

Biểu diễn dưới dạng JSON 
{
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "sectionType": enum (DeviceProvisioningSectionType),
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "preProvisioningToken": string,
  // Union field customer can be only one of the following:
  "customerId": string,
  "googleWorkspaceCustomerId": string
  // End of list of possible types for union field customer.
}
Các trường
deviceIdentifier

object (DeviceIdentifier)

Bắt buộc. Bắt buộc. Giá trị nhận dạng thiết bị để nhận.
sectionType

enum (DeviceProvisioningSectionType)

Bắt buộc. Loại mục trong bản ghi cấp phép của thiết bị.
deviceMetadata

object (DeviceMetadata)

Không bắt buộc. Siêu dữ liệu đính kèm vào thiết bị.
preProvisioningToken

string

Không bắt buộc. Phải và chỉ có thể đặt cho thiết bị Chrome OS.
Trường liên kết customer. Bắt buộc. Khách hàng mà thiết bị đang được xác nhận quyền sở hữu. customer chỉ có thể là một trong những trạng thái sau:
customerId

string (int64 format)

Mã của khách hàng được xác nhận quyền sở hữu thiết bị.
googleWorkspaceCustomerId

string

Mã khách hàng Google Workspace.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Thông báo phản hồi chứa mã thiết bị của thông báo xác nhận quyền sở hữu.

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

string (int64 format)

Mã thiết bị của thiết bị đã xác nhận quyền sở hữu.
deviceName

string

Tên tài nguyên của thiết bị ở định dạng partners/[PARTNER_ID]/devices/[DEVICE_ID].

Phạm vi cấp phép

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/androidworkprovisioning

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.