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 標準化,並使用 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

裝置的活動狀態。

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

方法

get

取得遙測使用者。

list

列出所有遙測使用者。