Method: customers.telemetry.events.list
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Listar eventos de telemetria.
Solicitação HTTP
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
parent |
string
Obrigatório. ID de cliente ou "my_customer" usar o cliente associado à conta que fez a solicitação.
|
Parâmetros de consulta
| Parâmetros |
filter |
string
Opcional. Inclua apenas recursos que correspondam ao filtro. Embora esse parâmetro seja opcional no momento, ele é obrigatório. Especifique pelo menos um tipo de evento. Campos de filtro compatíveis: - deviceId
- userId
- deviceOrgUnitId
- userOrgUnitId
- timestamp
- eventType
O "carimbo de data/hora" o filtro aceita o formato de milissegundos da época Unix ou o formato RFC3339 UTC "Zulu" com resolução de nanossegundos e até nove dígitos fracionários. Os dois formatos devem ser colocados entre aspas duplas simples. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".
|
readMask |
string (FieldMask format)
Obrigatório. Leia a máscara para especificar quais campos retornar. Esse campo será opcional, mas o parâmetro de filtro com um tipo de evento será obrigatório no momento. Os caminhos de readMask compatíveis são: - dispositivo
- usuário
- audioSevereUnderrunEvent
- usbPeripheralsEvent
- httpsLatencyChangeEvent
- networkStateChangeEvent
- wifiSignalStrengthEvent
- vpnConnectionStateChangeEvent
- appInstallEvent
- appUninstallEvent
- appLaunchEvent
- osCrashEvent
É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
|
pageSize |
integer
Opcional. Número máximo de resultados a serem retornados. O valor padrão é 100. O valor máximo é 1.000.
|
pageToken |
string
Opcional. Token para especificar a próxima página na lista.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Mensagem de resposta para listar eventos de telemetria de um cliente.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
| Representação JSON |
{
"telemetryEvents": [
{
object (TelemetryEvent)
}
],
"nextPageToken": string
} |
| Campos |
telemetryEvents[] |
object (TelemetryEvent)
Eventos de telemetria retornados na resposta.
|
nextPageToken |
string
Token para especificar a próxima página na lista.
|
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 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`"]]
