Method: customers.telemetry.events.list

列出遥测事件。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

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

查询参数

参数
filter

string

可选。仅包含与过滤条件匹配的资源。虽然此参数目前是可选的，但以后会成为必需参数，请指定至少 1 种事件类型。

支持的过滤字段：

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • 时间戳
  • eventType
“timestamp”过滤条件接受 Unix 纪元毫秒格式或 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，精确到纳秒，最多九个小数位。这两种格式都应使用英文双引号括起来。示例：“2014-10-02T15:01:23Z”“2014-10-02T15:01:23.045123456Z”“1679283943823”。
readMask

string (FieldMask format)

必需。用于指定要返回哪些字段的读取掩码。虽然目前是必需的，但此字段将变为可选，而包含事件类型的过滤参数将变为必需。

支持的 readMask 路径包括：

  • 设备
  • 用户
  • audioSevereUnderrunEvent
  • usbPeripheralsEvent
  • httpsLatencyChangeEvent
  • networkStateChangeEvent
  • wifiSignalStrengthEvent
  • vpnConnectionStateChangeEvent
  • appInstallEvent
  • appUninstallEvent
  • appLaunchEvent
  • osCrashEvent
  • externalDisplaysEvent

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

integer

可选。页面中结果的数量上限。默认值为 100。最大值为 1000。
pageToken

string

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

请求正文

请求正文必须为空。

响应正文

用于列出客户的遥测事件的响应消息。

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

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

object (TelemetryEvent)

响应中返回的遥测事件。
nextPageToken

string

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

授权范围

需要以下 OAuth 作用域：

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