REST Resource: customers.telemetry.users

资源：TelemetryUser

从受管理的用户收集的遥测数据。

  • 所需精细化权限：TELEMETRY_API_USER
JSON 表示法 
{
  "name": string,
  "customer": string,
  "orgUnitId": string,
  "userId": string,
  "userEmail": string,
  "userDevice": [
    {
      object (TelemetryUserDevice)
    }
  ]
}
字段
name

string

用户的资源名称。
customer

string

企业已注册相应设备的 G Suite 客户。
orgUnitId

string

用户的组织部门。
userId

string

用户的目录 ID。
userEmail

string

用户的电子邮件地址。
userDevice[]

object (TelemetryUserDevice)

从受管理的用户和设备收集的遥测数据。

TelemetryUserDevice

为受管理的用户和设备收集的遥测数据。

  • 所需精细化权限：TELEMETRY_API_DEVICE
JSON 表示法 
{
  "deviceId": string,
  "audioStatusReport": [
    {
      object (AudioStatusReport)
    }
  ],
  "deviceActivityReport": [
    {
      object (DeviceActivityReport)
    }
  ],
  "networkBandwidthReport": [
    {
      object (NetworkBandwidthReport)
    }
  ],
  "peripheralsReport": [
    {
      object (PeripheralsReport)
    }
  ],
  "appReport": [
    {
      object (AppReport)
    }
  ]
}
字段
deviceId

string

设备的唯一 Directory API ID。此值与“ChromeOS 设备”标签页中管理控制台的 Directory API ID 相同。
audioStatusReport[]

object (AudioStatusReport)

仅限输出。定期收集的音频报告，按 reportTime 降序排序。
deviceActivityReport[]

object (DeviceActivityReport)

仅限输出。定期收集的设备活动记录报告，按 reportTime 降序排序。
networkBandwidthReport[]

object (NetworkBandwidthReport)

仅限输出。定期收集的网络带宽报告，按 reportTime 降序排序。
peripheralsReport[]

object (PeripheralsReport)

仅限输出。定期收集的外围设备报告，按 reportTime 降序排序。
appReport[]

object (AppReport)

仅限输出。定期收集的应用报告，按 reportTime 降序排序。

DeviceActivityReport

设备活动记录。

  • 所需精细权限：TELEMETRY_API_DEVICE_ACTIVITY_REPORT
JSON 表示法 
{
  "reportTime": string,
  "deviceActivityState": enum (DeviceActivityState)
}
字段
reportTime

string (Timestamp format)

仅限输出。报告收集时间的时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
deviceActivityState

enum (DeviceActivityState)

仅限输出。设备活动状态。

DeviceActivityState

设备的 activity 状态。

枚举
DEVICE_ACTIVITY_STATE_UNSPECIFIED 设备活动状态未指定。
ACTIVE 设备目前正在使用中。
IDLE 设备目前处于闲置状态。
LOCKED 设备目前处于锁定状态。

方法

get

 获取遥测用户。

list

 列出所有遥测用户。