AI-generated Key Takeaways
-
You can list telemetry events using a GET request to the specified URL with parent path parameter.
-
You can optionally filter events by deviceId, userId, deviceOrgUnitId, userOrgUnitId, timestamp, or eventType.
-
A readMask is required to specify which fields to return, though this will become optional in the future while the filter parameter with an event type will become required.
-
The response body contains a list of telemetry events and an optional token for the next page.
- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
List telemetry events.
HTTP request
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
parent
|
Required. Customer id or "my_customer" to use the customer associated to the account making the request. |
Query parameters
filter
string
Optional. Only include resources that match the filter. Although this parameter is currently optional, this parameter will be required- please specify at least 1 event type.
Supported filter fields:
- deviceId
- userId
- deviceOrgUnitId
- userOrgUnitId
- timestamp
- eventType
readMask
string (
FieldMask
format)
Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required.
Supported readMask paths are:
- device
- user
- audioSevereUnderrunEvent
- usbPeripheralsEvent
- httpsLatencyChangeEvent
- networkStateChangeEvent
- wifiSignalStrengthEvent
- vpnConnectionStateChangeEvent
- appInstallEvent
- appUninstallEvent
- appLaunchEvent
- osCrashEvent
This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo"
.
pageSize
integer
Optional. Maximum number of results to return. Default value is 100. Maximum value is 1000.
pageToken
string
Optional. Token to specify next page in the list.
Request body
The request body must be empty.
Response body
Response message for listing telemetry events for a customer.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"telemetryEvents"
:
[
{
object (
|
| Fields | |
|---|---|
telemetryEvents[]
|
Telemetry events returned in the response. |
nextPageToken
|
Token to specify next page in the list. |
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
