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

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 アプリのインストール元が 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 [App Managedment] ページからアンインストールされたアプリケーション。
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 Login から起動されたアプリケーション。
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 インストール可能なウェブ UI の chrome://password-manager のプロファイル メニューから起動したアプリケーション。
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 フォーカス パネルから起動されたアプリケーション。

メソッド

list

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