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)
  }
}
フィールド
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)

出力専用。ネットワーク接続状態変更イベントのペイロード。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 の場合にのみ存在します。

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

Wi-Fi 電波強度イベントが発生すると、TelemetryNetworkSignalStrengthEvent がトリガーされます。

  • 詳細な権限が必要: 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 アプリのインストール元が 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 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 WebUI のプロファイル メニューから起動されたアプリケーション
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 から起動されたアプリ。

メソッド

list

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