Method: chromeosdevices.list

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

HTTP 要求

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

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

路徑參數

參數
customerId

string

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

查詢參數

參數
maxResults

integer

要傳回的結果數上限。值不得超過 300。
orderBy

enum (OrderBy)

用來排序結果的裝置屬性。
orgUnitPath

string

機構單位的完整路徑 (不含開頭的 /) 或專屬 ID。
pageToken

string

pageToken 查詢參數可用來要求下一頁的查詢結果。後續要求的 pageToken 查詢參數就是前一次回應中的 nextPageToken。
projection

enum (Projection)

指定回應是否應包含完整屬性清單，或只顯示一部分屬性。
query

string

搜尋字串，格式請參閱 https://developers.google.com/workspace/admin/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 查詢字串中使用這個符記的值。

授權範圍

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

  • https://www.googleapis.com/auth/admin.directory.device.chromeos
  • https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly

詳情請參閱授權指南。

排序依據

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

預測值

裝置要顯示的投影類型。

列舉
BASIC 只包含基本中繼資料欄位 (例如 deviceId、serialNumber、status 和 user)
FULL 包含所有中繼資料欄位

SortOrder

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

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