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)
  },
  "externalDisplaysEvent": {
    object (TelemetryExternalDisplayEvent)
  }
}
フィールド
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 の場合にのみ存在します。
externalDisplaysEvent

object (TelemetryExternalDisplayEvent)

出力専用。外部ディスプレイの接続/切断イベントのペイロード。eventType が EXTERNAL_DISPLAY_CONNECTED または EXTERNAL_DISPLAY_DISCONNECTED の場合にのみ存在します。

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 Chrome OS の一部としてインストールされたアプリ。
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 Chrome OS のキオスクによってインストールされたアプリ。
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 から起動されたアプリケーション。
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING ナビゲーション キャプチャから起動されたアプリ。
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API ウェブ インストール 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 セッション。

TelemetryExternalDisplayEvent

外部ディスプレイの接続/切断イベントのペイロード。

JSON 表現 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
フィールド
externalDisplayData[]

object (TelemetryExternalDisplayData)

接続/切断された外部ディスプレイのリスト。

TelemetryExternalDisplayData

外部ディスプレイのデータ。

JSON 表現 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
フィールド
displayName

string

表示名。
resolutionHorizontal

integer

水平解像度。
resolutionVertical

integer

垂直解像度。
refreshRate

string (int64 format)

リフレッシュ レート。
serialNumber

integer

シリアル番号。
edidVersion

string

EDID バージョン。

メソッド

list

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