Method: customers.telemetry.events.list
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Список событий телеметрии.
HTTP-запрос
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
parent | string Необходимый. Идентификатор клиента или «my_customer», чтобы использовать клиента, связанного с учетной записью, делающей запрос. |
Параметры запроса
| Параметры |
|---|
filter | string Необязательный. Включайте только ресурсы, соответствующие фильтру. Хотя этот параметр в настоящее время является необязательным, он будет обязательным — укажите хотя бы один тип события. Поддерживаемые поля фильтра: - идентификатор устройства
- ID пользователя
- устройствоOrgUnitId
- userOrgUnitId
- временная метка
- тип события
Фильтр «временная метка» принимает либо миллисекундный формат Unix Epoch, либо формат RFC3339 UTC «Zulu» с наносекундным разрешением и до девяти дробных цифр. Оба формата должны быть заключены в простые двойные кавычки. Примеры: «2014-10-02T15:01:23Z», «2014-10-02T15:01:23.045123456Z», «1679283943823». |
readMask | string ( FieldMask format) Необходимый. Прочитайте маску, чтобы указать, какие поля возвращать. Хотя в настоящее время это поле является обязательным, оно станет необязательным, а параметр фильтра с типом события станет обязательным. Поддерживаемые пути readMask: - устройство
- пользователь
- audioSevereUnderrunEvent
- USBPeripheralsEvent
- httpsLatencyChangeEvent
- сетьстатечанжевент
- Wi-FiСигналСилаСобытие
- vpnConnectionStateChangeEvent
- приложениеInstallEvent
- приложениеУнисталлЕвент
- приложениеLaunchEvent
- osCrashEvent
Это разделенный запятыми список полных имен полей. Пример: "user.displayName,photo" . |
pageSize | integer Необязательный. Максимальное количество возвращаемых результатов. Значение по умолчанию — 100. Максимальное значение — 1000. |
pageToken | string Необязательный. Токен для указания следующей страницы в списке. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Ответное сообщение для перечисления событий телеметрии для клиента.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"telemetryEvents": [
{
object (TelemetryEvent)
}
],
"nextPageToken": string
} |
| Поля |
|---|
telemetryEvents[] | object ( TelemetryEvent ) В ответ вернулись события телеметрии. |
nextPageToken | string Токен для указания следующей страницы в списке. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 UTC."],[[["\u003cp\u003eList telemetry events for a specific customer using the provided endpoint.\u003c/p\u003e\n"],["\u003cp\u003eFilter results by device, user, organizational unit, timestamp, or event type using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eSpecify desired fields in the response using the \u003ccode\u003ereadMask\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of telemetry events and a token for pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.telemetry.readonly\u003c/code\u003e authorization scope.\u003c/p\u003e\n"]]],[],null,["# Method: customers.telemetry.events.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListTelemetryEventsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nList telemetry events.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Customer id or \"my_customer\" to use the customer associated to the account making the request. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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 The \"timestamp\" filter accepts either the Unix Epoch milliseconds format or the RFC3339 UTC \"Zulu\" format with nanosecond resolution and up to nine fractional digits. Both formats should be surrounded by simple double quotes. Examples: \"2014-10-02T15:01:23Z\", \"2014-10-02T15:01:23.045123456Z\", \"1679283943823\". \u003cbr /\u003e |\n| `readMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` 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 \u003cbr /\u003e This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `pageSize` | `integer` Optional. Maximum number of results to return. Default value is 100. Maximum value is 1000. |\n| `pageToken` | `string` Optional. Token to specify next page in the list. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for listing telemetry events for a customer.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"telemetryEvents\": [ { object (/chrome/management/reference/rest/v1/customers.telemetry.events#TelemetryEvent) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `telemetryEvents[]` | `object (`[TelemetryEvent](/chrome/management/reference/rest/v1/customers.telemetry.events#TelemetryEvent)`)` Telemetry events returned in the response. |\n| `nextPageToken` | `string` Token to specify next page in the list. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.telemetry.readonly`"]]
