AI-generated Key Takeaways
-
The Chrome Management Telemetry API monitors the operation and health of ChromeOS devices.
-
Appropriate reporting policies must be enabled for data to be reported from devices.
-
The API provides methods to list telemetry information for devices, users, events, and notification configs.
-
Admin users need specific "read only" permissions for Chrome Management to use this API.
-
The API requires the
https://www.googleapis.com/auth/chrome.management.telemetry.readonlyOAuth scope.
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
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/ | GET |
| List telemetry information for ChromeOS users | /telemetry/users/ | GET |
| List telemetry events for given customer | /telemetry/events/ | GET |
| List telemetry notification configs for given customer | /telemetry/notificationConfigs/ | GET |
See code samples 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".
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.