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 總覽。