Method: partners.devices.findByOwner

Tìm thiết bị đã 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ý với đại lý được đối số partnerId xác định. Thiết bị của khách hàng mua từ các đại lý khác 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

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

string

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

string (int64 format)

Bắt buộc. Số lượng thiết bị tối đa để hiển thị trong một trang kết quả. Phải bao gồm từ 1 đến 100.
sectionType

enum (DeviceProvisioningSectionType)

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

string (int64 format)

Danh sách mã khách hàng để tìm kiếm.
googleWorkspaceCustomerId[]

string

Danh sách mã nhận dạng của 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:

Phản hồ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
}
Các trường
devices[]

object (Device)

Thiết bị của khách hàng.
nextPageToken

string

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

integer

Tổng số mục trong danh sách, bất kể tính năng 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.