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)
  },
  "appInstallEvent": {
    object (TelemetryAppInstallEvent)
  },
  "appUninstallEvent": {
    object (TelemetryAppUninstallEvent)
  },
  "appLaunchEvent": {
    object (TelemetryAppLaunchEvent)
  },
  "osCrashEvent": {
    object (TelemetryOsCrashEvent)
  }
}
フィールド
name

string

出力専用。イベントのリソース名。
device

object (TelemetryDeviceInfo)

出力専用。イベントに関連付けられているデバイスに関する情報。
user

object (TelemetryUserInfo)

出力専用。イベントに関連付けられているユーザーに関する情報。
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"。
eventType

enum (EventType)

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

object (TelemetryAudioSevereUnderrunEvent)

出力専用。音声の重大な不足イベントのペイロード。eventType フィールドが AUDIO_SEVERE_UNDERRUN の場合にのみ存在します。
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

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

object (TelemetryNetworkConnectionStateChangeEvent)

出力専用。ネットワーク接続状態変化イベントのペイロード。eventType が NETWORK_STATE_CHANGE の場合にのみ存在します。
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

出力専用。HTTPS レイテンシ変更イベントのペイロード。eventType が NETWORK_HTTPS_LATENCY_CHANGE の場合にのみ存在します。
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

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

object (TelemetryNetworkConnectionStateChangeEvent)

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

object (TelemetryAppInstallEvent)

出力専用。アプリ インストール イベントのペイロード。eventType が APP_INSTALLED の場合にのみ存在します。
appUninstallEvent

object (TelemetryAppUninstallEvent)

出力専用。アプリのアンインストール イベントのペイロード。eventType が APP_UNINSTALLED の場合にのみ存在します。
appLaunchEvent

object (TelemetryAppLaunchEvent)

出力専用。アプリ起動イベントのペイロード。eventType が APP_LAUNCHED の場合にのみ存在します。
osCrashEvent

object (TelemetryOsCrashEvent)

出力専用。OS クラッシュ イベントのペイロード。eventType が OS_CRASH の場合にのみ存在します。

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 値。

TelemetryAppInstallEvent

アプリのインストール データ。

JSON 表現 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
フィールド
appInstallSource

enum (ApplicationInstallSource)

アプリのインストール元。
appInstallReason

enum (ApplicationInstallReason)

アプリのインストール理由。
appInstallTime

enum (ApplicationInstallTime)

アプリのインストール時間は、アプリのライフサイクルによって異なります。
appId

string

アプリ ID。PWA の場合は開始 URL、拡張機能の場合は拡張機能 ID です。
appType

enum (TelemetryApplicationType)

アプリの種類。

ApplicationInstallSource

アプリのインストール元を説明します。

列挙型
APPLICATION_INSTALL_SOURCE_UNSPECIFIED アプリのインストール元が不明です。
APPLICATION_INSTALL_SOURCE_SYSTEM ChromeOS の一部としてインストールされたアプリ。
APPLICATION_INSTALL_SOURCE_SYNC アプリケーションのインストール元が同期である。
APPLICATION_INSTALL_SOURCE_PLAY_STORE アプリのインストール元が Google Play ストアである。
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE アプリのインストール元は Chrome ウェブストアです。
APPLICATION_INSTALL_SOURCE_BROWSER アプリのインストール元がブラウザである。

ApplicationInstallReason

アプリのインストール理由を説明します。

列挙型
APPLICATION_INSTALL_REASON_UNSPECIFIED アプリのインストール理由は不明です。
APPLICATION_INSTALL_REASON_SYSTEM システムとともにインストールされ、OS の一部と見なされるアプリ。
APPLICATION_INSTALL_REASON_POLICY ポリシーによってインストールされたアプリ。
APPLICATION_INSTALL_REASON_OEM 相手先ブランド製品製造企業（OEM）がインストールしたアプリ。
APPLICATION_INSTALL_REASON_DEFAULT デフォルトでインストールされるアプリですが、システムアプリとは見なされません。
APPLICATION_INSTALL_REASON_SYNC 同期によってインストールされたアプリ。
APPLICATION_INSTALL_REASON_USER ユーザーの操作によってインストールされたアプリ。
APPLICATION_INSTALL_REASON_SUB_APP SubApp API 呼び出しによってインストールされたアプリケーション。
APPLICATION_INSTALL_REASON_KIOSK ChromeOS のキオスクによってインストールされたアプリ。
APPLICATION_INSTALL_REASON_COMMAND_LINE コマンドライン引数でインストールされたアプリケーション。

ApplicationInstallTime

アプリのライフサイクルに応じたアプリのインストール時間について説明します。

列挙型
APPLICATION_INSTALL_TIME_UNSPECIFIED アプリのインストール時間は不明です。
APPLICATION_INSTALL_TIME_INIT アプリケーションのインストールが初期化されます。
APPLICATION_INSTALL_TIME_RUNNING アプリケーションのインストールが現在実行中です。

TelemetryAppUninstallEvent

アプリのアンインストール データ。

JSON 表現 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
フィールド
appUninstallSource

enum (ApplicationUninstallSource)

アプリのアンインストール元。
appId

string

アプリ ID。PWA の場合は開始 URL、拡張機能の場合は拡張機能 ID です。
appType

enum (TelemetryApplicationType)

アプリの種類。

ApplicationUninstallSource

アプリのアンインストール元を説明します。

列挙型
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED アプリのアンインストール元不明。
APPLICATION_UNINSTALL_SOURCE_APP_LIST アプリリスト（ランチャー）からアプリがアンインストールされた。
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT アプリ管理ページからアプリがアンインストールされた。
APPLICATION_UNINSTALL_SOURCE_SHELF シェルフからアンインストールされたアプリ。
APPLICATION_UNINSTALL_SOURCE_MIGRATION アプリの移行によってアンインストールされたアプリ。

TelemetryAppLaunchEvent

アプリの起動データ。

JSON 表現 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
フィールド
appLaunchSource

enum (ApplicationLaunchSource)

アプリの起動元。
appId

string

アプリ ID。PWA の場合は開始 URL、拡張機能の場合は拡張機能 ID です。
appType

enum (TelemetryApplicationType)

アプリの種類。

ApplicationLaunchSource

アプリの起動元を説明します。

列挙型
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED アプリの起動元が不明です。
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID 検索ボックスではなく、アプリのグリッドから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU コンテキスト メニューではなく、アプリのグリッドから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY クエリに依存する結果から起動されたアプリ（アイコンが大きい）。
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU クエリに依存する結果から、コンテキスト メニュー以外で起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION クエリなしのおすすめから起動されたアプリ（小さいアイコン）。
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS [保護者による使用制限の設定] セクションとアプリごとの使用時間の通知から起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_SHELF セクションから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER ファイル マネージャーから起動されたアプリ
APPLICATION_LAUNCH_SOURCE_OMNIBOX ブラウザのアドレスバーに URL を入力して起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Chrome 内部呼び出しから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_KEYBOARD アプリを開くためのキーボード ショートカットから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_OTHER_APP 別のアプリまたは WebUI でリンクをクリックして起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_MENU メニューから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION インストール済みの通知から起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_TEST テストから起動されたアプリケーション。
APPLICATION_LAUNCH_SOURCE_ARC Arc から起動されたアプリケーション。
APPLICATION_LAUNCH_SOURCE_SHARESHEET 共有シートから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION リリースノートの通知から起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE 完全復元から起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU スマート テキスト選択コンテキスト メニューから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION 発見タブの通知から起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Management API から起動されたアプリケーション。
APPLICATION_LAUNCH_SOURCE_KIOSK キオスクから起動されたアプリケーション。
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE コマンドラインから起動されたアプリケーション。
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE バックグラウンド モードから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE 新しいタブページから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_INTENT_URL インテント URL から起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_OS_LOGIN OS ログインから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER プロトコル ハンドラから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_URL_HANDLER URL ハンドラから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN ロック画面のアプリ ランチャーから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE アプリのホーム（chrome://apps）ページから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_REPARENTING コンテンツをアプリに移動したときに起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU インストール可能な chrome://password-manager ウェブ UI のプロファイル メニューから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR システムトレイのカレンダーから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_INSTALLER ソース インストーラから起動されたアプリケーション。
APPLICATION_LAUNCH_SOURCE_FIRST_RUN 初回起動のヘルプアプリの起動を個別にカウントして、ユーザーがトリガーした起動の数を把握できるようにします。
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR ウェルカム ツアーから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE フォーカス パネルから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_SPARKY 試験運用版機能 Sparky から起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING ナビゲーション キャプチャから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Web Install API から起動されたアプリケーション。

TelemetryOsCrashEvent

OS クラッシュ データ。

JSON 表現 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
フィールド
crashType

enum (CrashType)

クラッシュの種類。
sessionType

enum (SessionType)

セッションのタイプ。
crashId

string

クラッシュ ID。

CrashType

クラッシュのタイプを記述します。

列挙型
CRASH_TYPE_UNSPECIFIED クラッシュの種類は不明です。
CRASH_TYPE_KERNEL カーネルのクラッシュ。
CRASH_TYPE_EMBEDDED_CONTROLLER 組み込みコントローラのクラッシュ。

SessionType

セッション タイプを記述します。

列挙型
SESSION_TYPE_UNSPECIFIED セッション タイプ不明。
SESSION_TYPE_SIGNED_IN_USER ログイン ユーザー。
SESSION_TYPE_KIOSK キオスク。
SESSION_TYPE_MANAGED_GUEST 管理対象ゲスト セッション。
SESSION_TYPE_ACTIVE_DIRECTORY Active Directory セッション。

メソッド

list

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