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
Thông số | |
---|---|
partnerId |
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 ( |
Trường | |
---|---|
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 |
Bắt buộc. Loại mục của bản ghi cấp phép của thiết bị. |
deviceMetadata |
Không bắt buộc. Siêu dữ liệu cần đính kèm vào thiết bị. |
preProvisioningToken |
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 |
Mã của khách hàng được yêu cầu xác nhận thiết bị. |
googleWorkspaceCustomerId |
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 |
Mã thiết bị của thiết bị đã được xác nhận quyền sở hữu. |
deviceName |
Tên tài nguyên của thiết bị ở định dạng |
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.