REST Resource: customers.telemetry.events

リソース: TelemetryEvent

管理対象デバイスから報告されたテレメトリー データ。

JSON 表現
{
  "name": string,
  "device": {
    object (TelemetryDeviceInfo)
  },
  "user": {
    object (TelemetryUserInfo)
  },
  "reportTime": string,
  "eventType": enum (EventType),
  "audioSevereUnderrunEvent": {
    object (TelemetryAudioSevereUnderrunEvent)
  },
  "usbPeripheralsEvent": {
    object (TelemetryUsbPeripheralsEvent)
  },
  "networkStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  },
  "httpsLatencyChangeEvent": {
    object (TelemetryHttpsLatencyChangeEvent)
  },
  "wifiSignalStrengthEvent": {
    object (TelemetryNetworkSignalStrengthEvent)
  },
  "vpnConnectionStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  }
}
フィールド
name

string

出力のみ。イベントのリソース名。

device

object (TelemetryDeviceInfo)

出力のみ。イベントに関連付けられたデバイスに関する情報。

user

object (TelemetryUserInfo)

出力のみ。イベントに関連付けられたユーザーに関する情報。

reportTime

string (Timestamp format)

イベントが報告された時点を表すタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

eventType

enum (EventType)

現在のイベントのイベントタイプ。

audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

出力のみ。オーディオ重大なアンダーラン イベントのペイロード。eventType フィールドが AUDIO_SEVERE_UNDERRUN の場合にのみ存在します。

usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

出力のみ。USB 周辺機器イベントのペイロード。eventType フィールドが USB_ADDED または USB_REMOVED の場合にのみ存在します。

networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

出力のみ。ネットワーク接続状態変更イベントのペイロード。eventTypeNETWORK_STATE_CHANGE の場合にのみ存在します。

httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

出力のみ。HTTPS レイテンシ変更イベントのペイロード。eventTypeNETWORK_HTTPS_LATENCY_CHANGE の場合にのみ存在します。

wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

出力のみ。Wi-Fi 電波強度イベントのペイロード。eventTypeWIFI_SIGNAL_STRENGTH_LOW または WIFI_SIGNAL_STRENGTH_RECOVERED の場合にのみ存在します。

vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

出力のみ。VPN 接続状態変更イベントのペイロード。eventTypeVPN_CONNECTION_STATE_CHANGE の場合にのみ存在します。

TelemetryDeviceInfo

テレメトリー データに関連付けられたデバイスに関する情報。

  • 必要な詳細な権限: TELEMETRY_API_DEVICE
JSON 表現
{
  "deviceId": string,
  "orgUnitId": string
}
フィールド
deviceId

string

出力のみ。デバイスの一意の Directory API ID。この値は、管理コンソールの [ChromeOS デバイス] タブに表示される Directory API ID と同じです。

orgUnitId

string

出力のみ。デバイスの組織部門 ID。

TelemetryUserInfo

テレメトリー データに関連付けられたユーザーに関する情報。

  • 必要なきめ細かい権限: TELEMETRY_API_USER
JSON 表現
{
  "email": string,
  "orgUnitId": string
}
フィールド
email

string

出力のみ。ユーザーのメールアドレス。

orgUnitId

string

出力のみ。ユーザーの組織部門 ID。

TelemetryAudioSevereUnderrunEvent

このタイプにはフィールドがありません。

TelemetryAudioSevereUnderrunEvent は、オーディオ機器でバッファデータが 5 秒以上不足した場合にトリガーされます。

  • 必要なきめ細かい権限: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent がトリガーされると、USB デバイスの追加または削除が行われます。

  • 必要なきめ細かい権限: TELEMETRY_API_PERIPHERALS_REPORT
JSON 表現
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
フィールド
usbPeripheralReport[]

object (UsbPeripheralReport)

追加または削除された USB デバイスのリスト。

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent は、ネットワーク接続状態が変化するとトリガーされます。

  • 必要なきめ細かい権限: TELEMETRY_API_NETWORK_REPORT
JSON 表現
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
フィールド
guid

string

ネットワークの一意の識別子。

connectionState

enum (NetworkConnectionState)

ネットワークの現在の接続状態。

TelemetryHttpsLatencyChangeEvent

HTTPS レイテンシ ルーティンは定期的に実行され、レイテンシの問題が検出された場合、またはデバイスがレイテンシの問題から回復した場合に TelemetryHttpsLatencyChangeEvent がトリガーされます。

  • 必要なきめ細かい権限: TELEMETRY_API_NETWORK_REPORT
JSON 表現
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
フィールド
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

イベントをトリガーした HTTPS レイテンシ ルーティン データ。

httpsLatencyState

enum (HttpsLatencyState)

現在の HTTPS レイテンシ状態。

HttpsLatencyState

HTTPS レイテンシ状態。

列挙型
HTTPS_LATENCY_STATE_UNSPECIFIED HTTPS レイテンシ状態が指定されていません。
RECOVERY HTTPS レイテンシが問題から回復しました。
PROBLEM HTTPS レイテンシの問題です。

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent は Wi-Fi の電波強度イベントでトリガーされます。

  • 必要なきめ細かい権限: TELEMETRY_API_NETWORK_REPORT
JSON 表現
{
  "guid": string,
  "signalStrengthDbm": integer
}
フィールド
guid

string

ネットワークの一意の識別子。

signalStrengthDbm

integer

電波強度の RSSI 値。

Methods

list

テレメトリー イベントを一覧表示します。