Method: partners.devices.findByOwner

Tìm thiết bị đã được xác nhận quyền sở hữu cho khách hàng. Kết quả chỉ chứa các thiết bị đã đăng ký cho đại lý và được xác định bằng đối số partnerId. Các thiết bị của khách hàng đã mua từ đại lý khác sẽ không xuất hiện trong kết quả.

Yêu cầu HTTP

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

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
{
  "pageToken": string,
  "limit": string,
  "sectionType": enum (DeviceProvisioningSectionType),
  "customerId": [
    string
  ],
  "googleWorkspaceCustomerId": [
    string
  ]
}
Trường
pageToken

string

Mã thông báo chỉ định trang kết quả nào cần trả về.

limit

string (int64 format)

Bắt buộc. Số lượng thiết bị tối đa có thể xuất hiện trên một trang kết quả. Giá trị phải nằm trong khoảng từ 1 đến 100.

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ị.

customerId[]

string (int64 format)

Danh sách mã khách hàng cần tìm.

googleWorkspaceCustomerId[]

string

Danh sách mã nhận dạng của các tài khoản Google Workspace cần tìm.

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:

Câu trả lời chứa các thiết bị tìm thấy.

Biểu diễn dưới dạng JSON
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Trường
devices[]

object (Device)

Các thiết bị của khách hàng.

nextPageToken

string

Mã thông báo dùng để truy cập vào trang kết quả tiếp theo. Bỏ qua nếu không có thêm kết quả.

totalSize

integer

Tổng số mục trong danh sách, bất kể việc phân trang.

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.