尋找為客戶認領的裝置。結果中只會列出已註冊給經銷商的裝置 (可透過 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 總覽。