# Chrome Management Telemetry API

The Chrome Management Telemetry API enables you to monitor the operation
and health of devices running ChromeOS. Please note that the appropriate
reporting policies need to be enabled to ensure that data is reported from the
device. More details can be found [here](https://support.google.com/chrome/a/answer/1375678#zippy=%2Cdevice-reporting)

## Quick overview of API methods

URLs are relative to
`https://chromemanagement.googleapis.com/v1/customers/*$CUSTOMER*`

| Description | Relative URL | Http method |
|---|---|---|
| List telemetry information for ChromeOS devices | [/telemetry/devices/](https://developers.google.com/chrome/management/reference/rest/v1/customers.telemetry.devices/list) | GET |
| List telemetry information for ChromeOS users | [/telemetry/users/](https://developers.google.com/chrome/management/reference/rest/v1/customers.telemetry.users/list) | GET |
| List telemetry events for given customer | [/telemetry/events/](https://developers.google.com/chrome/management/reference/rest/v1/customers.telemetry.events/list) | GET |
| List telemetry notification configs for given customer | [/telemetry/notificationConfigs/](https://developers.google.com/chrome/management/reference/rest/v1/customers.telemetry.notificationConfigs/list) | GET |

See [code samples](https://developers.google.com/chrome/management/guides/samples_telemetryapi) for example
requests and responses.

## Admin Privileges

Telemetry API respects admin role delegation.

Admins must have the permission
"Services -\> Chrome Management -\> Manage ChromeOS Devices \> Manage ChromeOS Devices (read only)" to use the Telemetry API.

To manage admin roles and privileges, visit "Admin Console -\> Admin Roles".

> [!NOTE]
> **Note:** admin roles can be assigned directly to a Service Account.

## API scopes

Chrome Management Telemetry API requires the following OAuth scope:

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

For more information, see the
[Authentication Overview](https://cloud.google.com/docs/authentication/).