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