擷取帳戶內的 Chrome OS 裝置分頁清單。
HTTP 要求
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
客戶 Google Workspace 帳戶的專屬 ID。帳戶管理員也可以使用 |
查詢參數
參數 | |
---|---|
maxResults |
要傳回的結果數上限。值不得超過 300。 |
orderBy |
用於排序結果的裝置屬性。 |
orgUnitPath |
機構單位的完整路徑 (減開頭的 |
pageToken |
|
projection |
決定回應包含完整的屬性清單或僅包含子集。 |
query |
按照以下格式搜尋字串:https://developers.google.com/admin-sdk/directory/v1/list-query-operators |
sortOrder |
要依遞增或遞減順序傳回結果。必須與 |
includeChildOrgunits |
傳回所有子機構單位和指定機構單位的裝置。如果設為 true,「orgUnitPath」。 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"kind": string,
"etag": string,
"chromeosdevices": [
{
object ( |
欄位 | |
---|---|
kind |
資源種類。 |
etag |
資源的 ETag。 |
chromeosdevices[] |
Chrome OS 裝置物件清單。 |
nextPageToken |
存取此結果下一頁的權杖。如要存取下一頁,請在此要求的 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/admin.directory.device.chromeos
https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly
詳情請參閱授權指南。
OrderBy
列舉 | |
---|---|
ANNOTATED_LOCATION |
管理員註記的 Chrome 裝置位置。 |
ANNOTATED_USER |
Chromebook 使用者 (由管理員加註)。 |
LAST_SYNC |
Chrome 裝置上次與管理控制台政策設定同步處理的日期和時間。 |
NOTES |
由管理員加註的 Chrome 裝置附註。 |
SERIAL_NUMBER |
啟用裝置時輸入的 Chrome 裝置序號。 |
STATUS |
Chrome 裝置狀態。詳情請參閱「<a chromeosdevices」。 |
投影
裝置顯示的投影類型。
列舉 | |
---|---|
BASIC |
只包含基本中繼資料欄位 (例如 deviceId、serialNumber、status 和使用者) |
FULL |
包含所有中繼資料欄位 |
SortOrder
要套用到裝置清單的排序順序。
列舉 | |
---|---|
ASCENDING |
遞增順序。 |
DESCENDING |
遞減排序。 |