Method: customers.telemetry.users.list

列出所有遥测用户。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

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

查询参数

参数
filter

string

仅包含与过滤条件匹配的资源。

支持的过滤条件字段:

  • userId
  • userOrgUnitId

readMask

string (FieldMask format)

读取掩码以指定要返回的字段。

支持的 readMask 路径包括:

  • 名称
  • orgUnitId
  • userId
  • userEmail
  • userDevice.device_id
  • userDevice.audio_status_report
  • userDevice.device_activity_report
  • userDevice.network_bandwidth_report
  • userDevice.peripherals_report

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

pageSize

integer

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

pageToken

string

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

请求正文

请求正文必须为空。

响应正文

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

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

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

object (TelemetryUser)

响应中返回的遥测用户。

nextPageToken

string

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

授权范围

需要以下 OAuth 范围:

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