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)
    }
  ]
}
欄位
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 遞減排序)。

DeviceActivityReport

裝置活動報告。

  • 需要精細權限:TELEMETRY_API_DEVICE_ACTIVITY_REPORT
JSON 表示法
{
  "reportTime": string,
  "deviceActivityState": enum (DeviceActivityState)
}
欄位
reportTime

string (Timestamp format)

僅供輸出。收集報表的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

deviceActivityState

enum (DeviceActivityState)

僅供輸出。裝置活動狀態。

DeviceActivityState

裝置的活動狀態。

列舉
DEVICE_ACTIVITY_STATE_UNSPECIFIED 未指定裝置活動狀態。
ACTIVE 裝置目前正在使用中。
IDLE 裝置目前閒置中。
LOCKED 裝置目前已鎖定。

方法

get

取得遙測使用者。

list

列出所有遙測使用者。