Method: customers.telemetry.devices.list

列出所有遥测设备。

HTTP 请求

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/devices

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。客户 ID 或“my_customer”，用于使用与发出请求的账号关联的客户。

查询参数

参数
filter

string

可选。仅添加与过滤条件匹配的资源。如果请求未指定“reports_timestamp”值，则系统会默认仅返回近期报告。指定“reports_timestamp>=0”即可获取所有报告数据。

支持的过滤条件字段：

  • orgUnitId
  • serialNumber
  • deviceId
  • reports_timestamp
“reports_timestamp”过滤条件接受 Unix Epoch 毫秒格式或 RFC3339 UTC（即“祖鲁时”）格式，精确到纳秒，最多九个小数位。这两种格式都应用英文双引号括起来。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"1679283943823"。
readMask

string (FieldMask format)

必需。读取掩码，用于指定要返回的字段。

支持的 readMask 路径如下：

  • 名称
  • orgUnitId
  • deviceId
  • serialNumber
  • cpuInfo
  • cpuStatusReport
  • memoryInfo
  • memoryStatusReport
  • networkInfo
  • networkDiagnosticsReport
  • networkStatusReport
  • osUpdateStatus
  • graphicsInfo
  • graphicsStatusReport
  • batteryInfo
  • batteryStatusReport
  • storageInfo
  • storageStatusReport
  • thunderboltInfo
  • audioStatusReport
  • bootPerformanceReport
  • heartbeatStatusReport
  • networkBandwidthReport
  • peripheralsReport
  • kioskAppStatusReport
  • appReport
  • runtimeCountersReport

这是完全限定字段名称的逗号分隔列表。示例："user.displayName,photo"。
pageSize

integer

返回的结果数上限。默认值为 100。最大值为 1000。
pageToken

string

用于指定列表中下一页的令牌。

请求正文

请求正文必须为空。

响应正文

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "devices": [
    {
      object (TelemetryDevice)
    }
  ],
  "nextPageToken": string
}
字段
devices[]

object (TelemetryDevice)

响应中返回的遥测设备。
nextPageToken

string

用于指定列表中下一页的令牌。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/chrome.management.telemetry.readonly