---
title: "GET /v1/customers/{customersId}/telemetry/users/{usersId}"
method: GET
path: "/v1/customers/{customersId}/telemetry/users/{usersId}"
tags: ["customers"]
---

# GET /v1/customers/{customersId}/telemetry/users/{usersId}

`GET /v1/customers/{customersId}/telemetry/users/{usersId}`

## Request

- Base URL: `https://chromemanagement.googleapis.com`
- URL: `https://chromemanagement.googleapis.com/v1/customers/{customersId}/telemetry/users/{usersId}`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/chrome.management.telemetry.readonly`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/chrome.management.telemetry.readonly`

Get telemetry user.

## Path parameters

- `customersId` string, required
- `usersId` string, required

## Query parameters

- `readMask` string, google-fieldmask

## Response `200`

Successful response

- GoogleChromeManagementV1TelemetryUser: Telemetry data collected from a managed user. * Granular permission needed: TELEMETRY_API_USER
  - `customer` string: G Suite Customer whose enterprise enrolled the device.
  - `name` string: Resource name of the user.
  - `orgUnitId` string: Organization unit of the user.
  - `userDevice` GoogleChromeManagementV1TelemetryUserDevice[]: Telemetry data collected from a managed user and device.
    - `appReport` GoogleChromeManagementV1AppReport[]: Output only. App reports collected periodically sorted in a decreasing order of report_time.
      - `reportTime` string, google-datetime: Timestamp when the report was collected.
      - `usageData` GoogleChromeManagementV1AppUsageData[]: App usage data.
        - `appId` string: App id.
        - `appInstanceId` string: Application instance id. This will be unique per window/instance.
        - `appType` 'TELEMETRY_APPLICATION_TYPE_UNSPECIFIED' | 'APPLICATION_TYPE_ARC' | 'APPLICATION_TYPE_BUILT_IN' | 'APPLICATION_TYPE_CROSTINI' | 'APPLICATION_TYPE_CHROME_APP' | 'APPLICATION_TYPE_WEB' | 'APPLICATION_TYPE_MAC_OS' | 'APPLICATION_TYPE_PLUGIN_VM' | 'APPLICATION_TYPE_STANDALONE_BROWSER' | 'APPLICATION_TYPE_REMOTE' | 'APPLICATION_TYPE_BOREALIS' | 'APPLICATION_TYPE_SYSTEM_WEB' | 'APPLICATION_TYPE_STANDALONE_BROWSER_CHROME_APP' | 'APPLICATION_TYPE_EXTENSION' | 'APPLICATION_TYPE_STANDALONE_BROWSER_EXTENSION' | 'APPLICATION_TYPE_BRUSCHETTA': Type of app.
        - `runningDuration` string, google-duration: App foreground running time.
    - `audioStatusReport` GoogleChromeManagementV1AudioStatusReport[]: Output only. Audio reports collected periodically sorted in a decreasing order of report_time.
      - `inputDevice` string: Output only. Active input device's name.
      - `inputGain` integer: Output only. Active input device's gain in [0, 100].
      - `inputMute` boolean: Output only. Is active input device mute or not.
      - `outputDevice` string: Output only. Active output device's name.
      - `outputMute` boolean: Output only. Is active output device mute or not.
      - `outputVolume` integer: Output only. Active output device's volume in [0, 100].
      - `reportTime` string, google-datetime: Output only. Timestamp of when the sample was collected on device.
    - `deviceActivityReport` GoogleChromeManagementV1DeviceActivityReport[]: Output only. Device activity reports collected periodically sorted in a decreasing order of report_time.
      - `deviceActivityState` 'DEVICE_ACTIVITY_STATE_UNSPECIFIED' | 'ACTIVE' | 'IDLE' | 'LOCKED': Output only. Device activity state.
      - `reportTime` string, google-datetime: Output only. Timestamp of when the report was collected.
    - `deviceId` string: The unique Directory API ID of the device. This value is the same as the Admin Console's Directory API ID in the ChromeOS Devices tab.
    - `networkBandwidthReport` GoogleChromeManagementV1NetworkBandwidthReport[]: Output only. Network bandwidth reports collected periodically sorted in a decreasing order of report_time.
      - `downloadSpeedKbps` string, int64: Output only. Download speed in kilobits per second.
      - `reportTime` string, google-datetime: Output only. Timestamp of when the report was collected.
    - `peripheralsReport` GoogleChromeManagementV1PeripheralsReport[]: Output only. Peripherals reports collected periodically sorted in a decreasing order of report_time.
      - `reportTime` string, google-datetime: Output only. Timestamp of when the report was collected.
      - `usbPeripheralReport` GoogleChromeManagementV1UsbPeripheralReport[]: Reports of all usb connected devices.
        - `categories` string[]: Output only. Categories the device belongs to https://www.usb.org/defined-class-codes
        - `classId` integer: Output only. Class ID https://www.usb.org/defined-class-codes
        - `firmwareVersion` string: Output only. Firmware version
        - `name` string: Output only. Device name, model name, or product name
        - `pid` integer: Output only. Product ID
        - `subclassId` integer: Output only. Subclass ID https://www.usb.org/defined-class-codes
        - `vendor` string: Output only. Vendor name
        - `vid` integer: Output only. Vendor ID
  - `userEmail` string: Email address of the user.
  - `userId` string: Directory ID of the user.

---

[API](https://skmtc.dev/google/apis/chromemanagement.md) - [All operations](https://skmtc.dev/google/apis/chromemanagement/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/chromemanagement/revisions/872a15abbbd0?raw)