Method: partners.devices.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. Nếu một khách hàng khác đã xác nhận thiết bị, 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

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

Nội dung yêu cầu chứa dữ liệu có cấu trúc 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.
}
Trường
deviceIdentifier

object (DeviceIdentifier)

Bắt buộc. Bắt buộc. Mã nhận dạng thiết bị của thiết bị để xác nhận quyền sở hữu.

sectionType

enum (DeviceProvisioningSectionType)

Bắt buộc. Loại mục của 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 cần đính kèm vào thiết bị.

preProvisioningToken

string

Không bắt buộc. Phải và chỉ có thể được đặt cho các thiết bị ChromeOS.

Trường kết hợp 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 đây:
customerId

string (int64 format)

Mã của khách hàng được yêu cầu xác nhận 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:

Tin nhắn 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
}
Trường
deviceId

string (int64 format)

Mã thiết bị của thiết bị đã được 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.