尋找為客戶認領的裝置。結果只會包含向經銷商註冊,且以 partnerId 引數識別的裝置。該客戶向其他經銷商購買的裝置不會顯示在結果中。
HTTP 要求
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
| partnerId | 
 必要欄位。經銷商合作夥伴的 ID。 | 
要求主體
要求主體的資料會採用以下結構:
| JSON 表示法 | 
|---|
| {
  "pageToken": string,
  "limit": string,
  "sectionType": enum ( | 
| 欄位 | |
|---|---|
| pageToken | 
 用於指定要傳回結果網頁的符記。 | 
| limit | 
 必要欄位。要在結果頁面中顯示的裝置數量上限。必須介於 1 到 100 之間。 | 
| sectionType | 
 必要欄位。裝置佈建記錄的部分類型。 | 
| customerId[] | 
 要搜尋的客戶 ID 清單。 | 
| googleWorkspaceCustomerId[] | 
 要搜尋的 Google Workspace 帳戶 ID 清單。 | 
回應主體
如果成功,回應主體會含有以下結構的資料:
回應包含找到的裝置。
| JSON 表示法 | 
|---|
| {
  "devices": [
    {
      object ( | 
| 欄位 | |
|---|---|
| devices[] | 
 客戶的裝置。 | 
| nextPageToken | 
 用於存取下一頁結果的憑證。如果沒有其他結果,則省略。 | 
| totalSize | 
 清單中的項目總數,與分頁無關。 | 
授權範圍
需要下列 OAuth 範圍:
- https://www.googleapis.com/auth/androidworkprovisioning
詳情請參閱 OAuth 2.0 總覽。