Method: chromeosdevices.list

擷取帳戶中分頁的 Chrome OS 裝置清單。

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos

這個網址使用 gRPC 轉碼語法。

參數

參數
`customerId`	`string` 客戶 Google Workspace 帳戶的專屬 ID。身為帳戶管理員，您也可以使用 `my_customer` 別名來代表帳戶的`customerId`。`customerId` 也會在使用者資源中傳回。

customerId

string

客戶 Google Workspace 帳戶的專屬 ID。身為帳戶管理員，您也可以使用 my_customer 別名來代表帳戶的customerId。customerId 也會在使用者資源中傳回。

參數
`maxResults`	`integer` 要傳回的結果數上限。
`orderBy`	`enum (OrderBy)` 用來排序結果的裝置屬性。
`orgUnitPath`	`string` 機構單位的完整路徑 (減去開頭的 `/`) 或專屬 ID。
`pageToken`	`string` `pageToken` 查詢參數可用來要求下一頁的查詢結果。後續要求和 `pageToken` 查詢參數是先前回應的 `nextPageToken`。
`projection`	`enum (Projection)` 限制傳回一組所選欄位的資訊。
`query`	`string` 以 https://developers.google.com/admin-sdk/directory/v1/list-query-operators 中提供的格式搜尋字串
`sortOrder`	`enum (SortOrder)` 要以遞增或遞減順序傳回結果。必須搭配 `orderBy` 參數使用。
`includeChildOrgunits`	`boolean` 傳回所有子機構單位和指定機構單位的裝置。如果您將這個值設為 True，就必須提供 'orgUnitPath'。

要求主體必須為空白。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法
{ "kind": string, "etag": string, "chromeosdevices": [ { object (`ChromeOsDevice`) } ], "nextPageToken": string }

欄位
`kind`	`string` 這是資源類型。
`etag`	`string` 資源的 ETag。
`chromeosdevices[]`	`object (ChromeOsDevice)` Chrome OS 裝置物件清單。
`nextPageToken`	`string` 用於存取下一頁結果的權杖。如要存取下一頁，請在此要求的 `pageToken` 查詢字串中使用這個符記和 #39; 的值。

需要下列其中一種 OAuth 範圍：

詳情請參閱 OAuth 2.0 總覽。

OrderBy

列舉
`ANNOTATED_LOCATION`	管理員加註的 Chrome 裝置位置。
`ANNOTATED_USER`	由管理員加註的 Chromebook 使用者。
`LAST_SYNC`	Chrome 裝置上次與管理控制台政策設定同步處理的日期和時間。
`NOTES`	由管理員加註的 Chrome 裝置記事。
`SERIAL_NUMBER`	裝置啟用時輸入的 Chrome 裝置序號。
`STATUS`	Chrome 裝置狀態。詳情請參閱 ltdevice。

裝置要顯示的投影類型。

列舉
`BASIC`	只包含基本中繼資料欄位 (例如 deviceId、SerialNumber、status 和使用者)
`FULL`	包含所有中繼資料欄位

應套用至裝置清單的排序順序。

列舉
`ASCENDING`	遞增排序。
`DESCENDING`	遞減順序。