Method: partners.devices.findByOwner

查找已为客户领取的设备。结果仅包含已向转销商注册且由 partnerId 参数标识的设备。客户从其他转销商处购买的设备不会显示在结果中。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
partnerId

string (int64 format)

必需。转销商合作伙伴的 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "pageToken": string,
  "limit": string,
  "sectionType": enum (DeviceProvisioningSectionType),
  "customerId": [
    string
  ],
  "googleWorkspaceCustomerId": [
    string
  ]
}
字段
pageToken

string

用于指定要返回的结果页面的令牌。
limit

string (int64 format)

必需。每页结果中显示的设备数量上限。必须在 1 到 100 之间（含边界值）。
sectionType

enum (DeviceProvisioningSectionType)

必需。设备配置记录所属的部分类型。
customerId[]

string (int64 format)

要搜索的客户 ID 列表。
googleWorkspaceCustomerId[]

string

要搜索的 Google Workspace 账号的 ID 列表。

响应正文

如果成功，响应正文将包含结构如下的数据：

包含找到的设备的响应。

JSON 表示法 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
字段
devices[]

object (Device)

客户的设备。
nextPageToken

string

用于访问下一页结果的令牌。如果没有其他结果，则省略。
totalSize

integer

列表中与分页无关的项目总数。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅 OAuth 2.0 概览。