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)

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

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

deviceActivityState

enum (DeviceActivityState)

仅限输出。设备 activity 状态。

DeviceActivityState

设备的活动状态。

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

方法

get

获取遥测用户。

list

列出所有遥测用户。