Method: customers.telemetry.users.list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Muestra una lista de todos los usuarios de la telemetría.
Solicitud HTTP
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/users
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
parent |
string
Obligatorio. El ID de cliente o "my_customer" para usar el cliente asociado a la cuenta que realiza la solicitud
|
Parámetros de consulta
| Parámetros |
filter |
string
Solo incluye recursos que coincidan con el filtro. Campos de filtro compatibles:
|
readMask |
string (FieldMask format)
Máscara de lectura para especificar qué campos mostrar. Las rutas de acceso de readMask compatibles son las siguientes: - nombre
- orgUnitId
- userid
- userEmail
- userDevice.device_id
- userDevice.audio_status_report
- userDevice.device_activity_report
- userDevice.network_bandwidth_report
- userDevice.peripherals_report
- userDevice.app_report
Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
|
pageSize |
integer
Cantidad máxima de resultados que se mostrarán. El valor predeterminado es 100. El valor máximo es 1,000.
|
pageToken |
string
Es un token para especificar la página siguiente de la lista.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Mensaje de respuesta para enumerar los usuarios de telemetría de un cliente.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
{
"telemetryUsers": [
{
object (TelemetryUser)
}
],
"nextPageToken": string
} |
| Campos |
telemetryUsers[] |
object (TelemetryUser)
Usuarios de la telemetría que se muestran en la respuesta.
|
nextPageToken |
string
Es un token para especificar la página siguiente de la lista.
|
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eLists all telemetry users for a given customer with optional filtering, pagination, and field selection.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.telemetry.readonly\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the \u003ccode\u003e/v1/{parent=customers/*}/telemetry/users\u003c/code\u003e endpoint.\u003c/p\u003e\n"],["\u003cp\u003eRequest body should be empty; the response includes a list of \u003ccode\u003eTelemetryUser\u003c/code\u003e objects and a token for pagination.\u003c/p\u003e\n"]]],[],null,["# Method: customers.telemetry.users.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.ListTelemetryUsersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nList all telemetry users.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/users`\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` Only include resources that match the filter. Supported filter fields: - userId - userOrgUnitId \u003cbr /\u003e |\n| `readMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Read mask to specify which fields to return. Supported readMask paths are: - name - orgUnitId - userId - userEmail - userDevice.device_id - userDevice.audio_status_report - userDevice.device_activity_report - userDevice.network_bandwidth_report - userDevice.peripherals_report - userDevice.app_report \u003cbr /\u003e This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `pageSize` | `integer` Maximum number of results to return. Default value is 100. Maximum value is 1000. |\n| `pageToken` | `string` 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 users for a customer.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"telemetryUsers\": [ { object (/chrome/management/reference/rest/v1/customers.telemetry.users#TelemetryUser) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `telemetryUsers[]` | `object (`[TelemetryUser](/chrome/management/reference/rest/v1/customers.telemetry.users#TelemetryUser)`)` Telemetry users 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`"]]
