--- title: "GET /v1/customers/{customersId}/telemetry/events" method: GET path: "/v1/customers/{customersId}/telemetry/events" tags: ["customers"] --- # GET /v1/customers/{customersId}/telemetry/events `GET /v1/customers/{customersId}/telemetry/events` ## Request - Base URL: `https://chromemanagement.googleapis.com` - URL: `https://chromemanagement.googleapis.com/v1/customers/{customersId}/telemetry/events` - Auth: OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/chrome.management.telemetry.readonly` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/chrome.management.telemetry.readonly` List telemetry events. ## Path parameters - `customersId` string, required ## Query parameters - `filter` string - `pageSize` integer - `pageToken` string - `readMask` string, google-fieldmask ## Response `200` Successful response - GoogleChromeManagementV1ListTelemetryEventsResponse: Response message for listing telemetry events for a customer. - `nextPageToken` string: Token to specify next page in the list. - `telemetryEvents` GoogleChromeManagementV1TelemetryEvent[]: Telemetry events returned in the response. - `appInstallEvent` GoogleChromeManagementV1TelemetryAppInstallEvent: App installation data. - `appId` string: App id. For PWAs this is the start URL, and for extensions this is the extension id. - `appInstallReason` 'APPLICATION_INSTALL_REASON_UNSPECIFIED' | 'APPLICATION_INSTALL_REASON_SYSTEM' | 'APPLICATION_INSTALL_REASON_POLICY' | 'APPLICATION_INSTALL_REASON_OEM' | 'APPLICATION_INSTALL_REASON_DEFAULT' | 'APPLICATION_INSTALL_REASON_SYNC' | 'APPLICATION_INSTALL_REASON_USER' | 'APPLICATION_INSTALL_REASON_SUB_APP' | 'APPLICATION_INSTALL_REASON_KIOSK' | 'APPLICATION_INSTALL_REASON_COMMAND_LINE': App installation reason. - `appInstallSource` 'APPLICATION_INSTALL_SOURCE_UNSPECIFIED' | 'APPLICATION_INSTALL_SOURCE_SYSTEM' | 'APPLICATION_INSTALL_SOURCE_SYNC' | 'APPLICATION_INSTALL_SOURCE_PLAY_STORE' | 'APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE' | 'APPLICATION_INSTALL_SOURCE_BROWSER': App installation source. - `appInstallTime` 'APPLICATION_INSTALL_TIME_UNSPECIFIED' | 'APPLICATION_INSTALL_TIME_INIT' | 'APPLICATION_INSTALL_TIME_RUNNING': App installation time depending on the app lifecycle. - `appType` 'TELEMETRY_APPLICATION_TYPE_UNSPECIFIED' | 'APPLICATION_TYPE_ARC' | 'APPLICATION_TYPE_BUILT_IN' | 'APPLICATION_TYPE_CROSTINI' | 'APPLICATION_TYPE_CHROME_APP' | 'APPLICATION_TYPE_WEB' | 'APPLICATION_TYPE_MAC_OS' | 'APPLICATION_TYPE_PLUGIN_VM' | 'APPLICATION_TYPE_STANDALONE_BROWSER' | 'APPLICATION_TYPE_REMOTE' | 'APPLICATION_TYPE_BOREALIS' | 'APPLICATION_TYPE_SYSTEM_WEB' | 'APPLICATION_TYPE_STANDALONE_BROWSER_CHROME_APP' | 'APPLICATION_TYPE_EXTENSION' | 'APPLICATION_TYPE_STANDALONE_BROWSER_EXTENSION' | 'APPLICATION_TYPE_BRUSCHETTA': Type of app. - `appLaunchEvent` GoogleChromeManagementV1TelemetryAppLaunchEvent: App launch data. - `appId` string: App id. For PWAs this is the start URL, and for extensions this is the extension id. - `appLaunchSource` '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_LINK' | 'APPLICATION_LAUNCH_SOURCE_OMNIBOX' | 'APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL' | 'APPLICATION_LAUNCH_SOURCE_KEYBOARD' | 'APPLICATION_LAUNCH_SOURCE_OTHER_APP' | 'APPLICATION_LAUNCH_SOURCE_MENU' | 'APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION' | 'APPLICATION_LAUNCH_SOURCE_TEST' | 'APPLICATION_LAUNCH_SOURCE_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' | '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' | 'APPLICATION_LAUNCH_SOURCE_OS_LOGIN' | 'APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER' | 'APPLICATION_LAUNCH_SOURCE_URL_HANDLER' | 'APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN' | 'APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE' | 'APPLICATION_LAUNCH_SOURCE_REPARENTING' | 'APPLICATION_LAUNCH_SOURCE_PROFILE_MENU' | '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' | 'APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING' | 'APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API': App launch source. - `appType` 'TELEMETRY_APPLICATION_TYPE_UNSPECIFIED' | 'APPLICATION_TYPE_ARC' | 'APPLICATION_TYPE_BUILT_IN' | 'APPLICATION_TYPE_CROSTINI' | 'APPLICATION_TYPE_CHROME_APP' | 'APPLICATION_TYPE_WEB' | 'APPLICATION_TYPE_MAC_OS' | 'APPLICATION_TYPE_PLUGIN_VM' | 'APPLICATION_TYPE_STANDALONE_BROWSER' | 'APPLICATION_TYPE_REMOTE' | 'APPLICATION_TYPE_BOREALIS' | 'APPLICATION_TYPE_SYSTEM_WEB' | 'APPLICATION_TYPE_STANDALONE_BROWSER_CHROME_APP' | 'APPLICATION_TYPE_EXTENSION' | 'APPLICATION_TYPE_STANDALONE_BROWSER_EXTENSION' | 'APPLICATION_TYPE_BRUSCHETTA': Type of app. - `appUninstallEvent` GoogleChromeManagementV1TelemetryAppUninstallEvent: App uninstall data. - `appId` string: App id. For PWAs this is the start URL, and for extensions this is the extension id. - `appType` 'TELEMETRY_APPLICATION_TYPE_UNSPECIFIED' | 'APPLICATION_TYPE_ARC' | 'APPLICATION_TYPE_BUILT_IN' | 'APPLICATION_TYPE_CROSTINI' | 'APPLICATION_TYPE_CHROME_APP' | 'APPLICATION_TYPE_WEB' | 'APPLICATION_TYPE_MAC_OS' | 'APPLICATION_TYPE_PLUGIN_VM' | 'APPLICATION_TYPE_STANDALONE_BROWSER' | 'APPLICATION_TYPE_REMOTE' | 'APPLICATION_TYPE_BOREALIS' | 'APPLICATION_TYPE_SYSTEM_WEB' | 'APPLICATION_TYPE_STANDALONE_BROWSER_CHROME_APP' | 'APPLICATION_TYPE_EXTENSION' | 'APPLICATION_TYPE_STANDALONE_BROWSER_EXTENSION' | 'APPLICATION_TYPE_BRUSCHETTA': Type of app. - `appUninstallSource` 'APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED' | 'APPLICATION_UNINSTALL_SOURCE_APP_LIST' | 'APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT' | 'APPLICATION_UNINSTALL_SOURCE_SHELF' | 'APPLICATION_UNINSTALL_SOURCE_MIGRATION': App uninstall source. - `audioSevereUnderrunEvent` GoogleChromeManagementV1TelemetryAudioSevereUnderrunEvent: `TelemetryAudioSevereUnderrunEvent` is triggered when a audio devices run out of buffer data for more than 5 seconds. * Granular permission needed: TELEMETRY_API_AUDIO_REPORT - `device` GoogleChromeManagementV1TelemetryDeviceInfo: Information about a device associated with telemetry data. * Granular Permission needed: TELEMETRY_API_DEVICE - `deviceId` string: Output only. The unique Directory API ID of the device. This value is the same as the Admin Console's Directory API ID in the ChromeOS Devices tab. - `orgUnitId` string: Output only. Organization unit ID of the device. - `eventType` 'EVENT_TYPE_UNSPECIFIED' | 'AUDIO_SEVERE_UNDERRUN' | 'NETWORK_STATE_CHANGE' | 'USB_ADDED' | 'USB_REMOVED' | 'NETWORK_HTTPS_LATENCY_CHANGE' | 'WIFI_SIGNAL_STRENGTH_LOW' | 'WIFI_SIGNAL_STRENGTH_RECOVERED' | 'VPN_CONNECTION_STATE_CHANGE' | 'APP_INSTALLED' | 'APP_UNINSTALLED' | 'APP_LAUNCHED' | 'OS_CRASH' | 'EXTERNAL_DISPLAY_CONNECTED' | 'EXTERNAL_DISPLAY_DISCONNECTED': The event type of the current event. - `externalDisplaysEvent` GoogleChromeManagementV1TelemetryExternalDisplayEvent: External display connected/disconnected event payload. - `externalDisplayData` GoogleChromeManagementV1TelemetryExternalDisplayData[]: List of external displays that were connected/disconnected. - `displayName` string: The display name. - `edidVersion` string: The EDID version. - `refreshRate` string, int64: The refresh rate. - `resolutionHorizontal` integer: The horizontal resolution. - `resolutionVertical` integer: The vertical resolution. - `serialNumber` integer: The serial number. - `httpsLatencyChangeEvent` GoogleChromeManagementV1TelemetryHttpsLatencyChangeEvent: Https latency routine is run periodically and `TelemetryHttpsLatencyChangeEvent` is triggered if a latency problem was detected or if the device has recovered from a latency problem. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT - `httpsLatencyRoutineData` GoogleChromeManagementV1HttpsLatencyRoutineData: Data that describes the result of the HTTPS latency diagnostics routine, with the HTTPS requests issued to Google websites. - `latency` string, google-duration: Output only. HTTPS latency if routine succeeded or failed because of HIGH_LATENCY or VERY_HIGH_LATENCY. - `problem` 'HTTPS_LATENCY_PROBLEM_UNSPECIFIED' | 'FAILED_DNS_RESOLUTIONS' | 'FAILED_HTTPS_REQUESTS' | 'HIGH_LATENCY' | 'VERY_HIGH_LATENCY': Output only. HTTPS latency routine problem if a problem occurred. - `httpsLatencyState` 'HTTPS_LATENCY_STATE_UNSPECIFIED' | 'RECOVERY' | 'PROBLEM': Current HTTPS latency state. - `name` string: Output only. Resource name of the event. - `networkStateChangeEvent` GoogleChromeManagementV1TelemetryNetworkConnectionStateChangeEvent: `TelemetryNetworkConnectionStateChangeEvent` is triggered on network connection state changes. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT - `connectionState` 'NETWORK_CONNECTION_STATE_UNSPECIFIED' | 'ONLINE' | 'CONNECTED' | 'PORTAL' | 'CONNECTING' | 'NOT_CONNECTED': Current connection state of the network. - `guid` string: Unique identifier of the network. - `osCrashEvent` GoogleChromeManagementV1TelemetryOsCrashEvent: OS crash data. - `crashId` string: Crash id. - `crashType` 'CRASH_TYPE_UNSPECIFIED' | 'CRASH_TYPE_KERNEL' | 'CRASH_TYPE_EMBEDDED_CONTROLLER': Crash type. - `sessionType` 'SESSION_TYPE_UNSPECIFIED' | 'SESSION_TYPE_SIGNED_IN_USER' | 'SESSION_TYPE_KIOSK' | 'SESSION_TYPE_MANAGED_GUEST' | 'SESSION_TYPE_ACTIVE_DIRECTORY': Session type. - `reportTime` string, google-datetime: Timestamp that represents when the event was reported. - `usbPeripheralsEvent` GoogleChromeManagementV1TelemetryUsbPeripheralsEvent: `TelemetryUsbPeripheralsEvent` is triggered USB devices are either added or removed. * Granular permission needed: TELEMETRY_API_PERIPHERALS_REPORT - `usbPeripheralReport` GoogleChromeManagementV1UsbPeripheralReport[]: List of usb devices that were either added or removed. - `categories` string[]: Output only. Categories the device belongs to https://www.usb.org/defined-class-codes - `classId` integer: Output only. Class ID https://www.usb.org/defined-class-codes - `firmwareVersion` string: Output only. Firmware version - `name` string: Output only. Device name, model name, or product name - `pid` integer: Output only. Product ID - `subclassId` integer: Output only. Subclass ID https://www.usb.org/defined-class-codes - `vendor` string: Output only. Vendor name - `vid` integer: Output only. Vendor ID - `user` GoogleChromeManagementV1TelemetryUserInfo: Information about a user associated with telemetry data. * Granular permission needed: TELEMETRY_API_USER - `email` string: Output only. User's email. - `orgUnitId` string: Output only. Organization unit ID of the user. - `vpnConnectionStateChangeEvent` GoogleChromeManagementV1TelemetryNetworkConnectionStateChangeEvent: `TelemetryNetworkConnectionStateChangeEvent` is triggered on network connection state changes. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT - `connectionState` 'NETWORK_CONNECTION_STATE_UNSPECIFIED' | 'ONLINE' | 'CONNECTED' | 'PORTAL' | 'CONNECTING' | 'NOT_CONNECTED': Current connection state of the network. - `guid` string: Unique identifier of the network. - `wifiSignalStrengthEvent` GoogleChromeManagementV1TelemetryNetworkSignalStrengthEvent: `TelemetryNetworkSignalStrengthEvent` is triggered on WiFi signal strength events. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT - `guid` string: Unique identifier of the network. - `signalStrengthDbm` integer: Signal strength RSSI value. --- [API](https://skmtc.dev/google/apis/chromemanagement.md) - [All operations](https://skmtc.dev/google/apis/chromemanagement/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/chromemanagement/revisions/872a15abbbd0?raw)