Method: customers.telemetry.users.get

  • Retrieve detailed telemetry data for a specific user within your organization using the GET method.

  • Specify the user using the name path parameter and optionally filter the returned data with the readMask query parameter.

  • The API requires the https://www.googleapis.com/auth/chrome.management.telemetry.readonly OAuth scope for authorization.

  • Responses include a TelemetryUser object containing user details, device information, and various reports (audio status, device activity, network bandwidth, peripherals, and apps).

  • This endpoint uses gRPC Transcoding for its URL structure.

Get telemetry user.

HTTP request

GET https://chromemanagement.googleapis.com/v1/{name=customers/*/telemetry/users/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Name of the TelemetryUser to return.

Query parameters

Parameters
readMask

string (FieldMask 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

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of TelemetryUser.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/chrome.management.telemetry.readonly