Method: customers.telemetry.users.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elenca tutti gli utenti di telemetria.
Richiesta HTTP
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/users
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
parent |
string
Obbligatorio. ID cliente o "my_customer" per utilizzare il cliente associato all'account che effettua la richiesta.
|
Parametri di query
| Parametri |
filter |
string
Includi solo le risorse che corrispondono al filtro. Campi filtro supportati:
|
readMask |
string (FieldMask format)
Maschera di lettura per specificare i campi da restituire. I percorsi di readMask supportati sono: - nome
- orgUnitId
- userId
- userEmail
- userDevice.device_id
- userDevice.audio_status_report
- userDevice.device_activity_report
- userDevice.network_bandwidth_report
- userDevice.peripherals_report
- userDevice.app_report
Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".
|
pageSize |
integer
Il numero massimo di risultati da restituire. Il valore predefinito è 100. Il valore massimo è 1000.
|
pageToken |
string
Token per specificare la pagina successiva nell'elenco.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Messaggio di risposta per l'elenco degli utenti della telemetria per un cliente.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"telemetryUsers": [
{
object (TelemetryUser)
}
],
"nextPageToken": string
} |
| Campi |
telemetryUsers[] |
object (TelemetryUser)
Utenti di telemetria restituiti nella risposta.
|
nextPageToken |
string
Token per specificare la pagina successiva nell'elenco.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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`"]]
