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

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

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

## Request

- Base URL: `https://chromemanagement.googleapis.com`
- URL: `https://chromemanagement.googleapis.com/v1/customers/{customersId}/telemetry/users`
- 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`

List all telemetry users.

## Path parameters

- `customersId` string, required

## Query parameters

- `filter` string
- `pageSize` integer
- `pageToken` string
- `readMask` string, google-fieldmask

## Response `200`

Successful response

- GoogleChromeManagementV1ListTelemetryUsersResponse: Response message for listing telemetry users for a customer.
  - `nextPageToken` string: Token to specify next page in the list.
  - `telemetryUsers` GoogleChromeManagementV1TelemetryUser[]: Telemetry users returned in the response.
    - `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)