Method: customers.telemetry.users.get
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Receber o usuário da telemetria.
Solicitação HTTP
GET https://chromemanagement.googleapis.com/v1/{name=customers/*/telemetry/users/*}
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
name |
string
Obrigatório. Nome do TelemetryUser a ser retornado.
|
Parâmetros de consulta
| Parâmetros |
readMask |
string (FieldMask format)
Leia a máscara para especificar quais campos serão retornados. Os caminhos de readMask compatíveis são: - 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
É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de TelemetryUser.
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\u003eRetrieve detailed telemetry data for a specific user within your organization using the \u003ccode\u003eGET\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eSpecify the user using the \u003ccode\u003ename\u003c/code\u003e path parameter and optionally filter the returned data with the \u003ccode\u003ereadMask\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe API requires the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.telemetry.readonly\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eResponses include a \u003ccode\u003eTelemetryUser\u003c/code\u003e object containing user details, device information, and various reports (audio status, device activity, network bandwidth, peripherals, and apps).\u003c/p\u003e\n"],["\u003cp\u003eThis endpoint uses gRPC Transcoding for its URL structure.\u003c/p\u003e\n"]]],[],null,["# Method: customers.telemetry.users.get\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGet telemetry user.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{name=customers/*/telemetry/users/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------|\n| `name` | `string` Required. Name of the `TelemetryUser` to return. |\n\n### Query parameters\n\n| Parameters ||\n|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [TelemetryUser](/chrome/management/reference/rest/v1/customers.telemetry.users#TelemetryUser).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.telemetry.readonly`"]]
