检索账号中 Chrome 操作系统设备的分页列表。
HTTP 请求
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customerId |
客户的 Google Workspace 帐号的唯一 ID。作为帐号管理员,您还可以使用 |
查询参数
参数 | |
---|---|
maxResults |
返回的结果数上限。 |
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 操作系统设备对象的列表。 |
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。 |
Projection
要为设备显示的投影类型。
枚举 | |
---|---|
BASIC |
仅包含基本元数据字段(例如 deviceId、erialNumber、status 和用户) |
FULL |
包括所有元数据字段 |
SortOrder
应应用于设备列表的排序顺序。
枚举 | |
---|---|
ASCENDING |
升序。 |
DESCENDING |
降序。 |