AI-generated Key Takeaways
-
The Chrome Management API provides services for administrators to view, manage, and gain insights on Chrome OS and Chrome Browser devices.
-
The API offers various REST resources to interact with customer data, including profiles, telemetry information, and app management.
-
Administrators can use the API to manage certificate provisioning processes and retrieve reports on device status, installed apps, and printing activity.
-
The service uses
chromemanagement.googleapis.comas its service endpoint and provides discovery documents for v1 and v1alpha1 versions.
The Chrome Management API is a suite of services that allows Chrome administrators to view, manage and gain insights on their Chrome OS and Chrome Browser devices.
- REST Resource: v1alpha1.customers.profiles
- REST Resource: v1alpha1.customers.telemetry.devices
- REST Resource: v1alpha1.customers.telemetry.events
- REST Resource: v1alpha1.customers.telemetry.notificationConfigs
- REST Resource: v1alpha1.customers.telemetry.users
- REST Resource: v1.customers.apps
- REST Resource: v1.customers.apps.android
- REST Resource: v1.customers.apps.chrome
- REST Resource: v1.customers.apps.web
- REST Resource: v1.customers.certificateProvisioningProcesses
- REST Resource: v1.customers.certificateProvisioningProcesses.operations
- REST Resource: v1.customers.profiles
- REST Resource: v1.customers.profiles.commands
- REST Resource: v1.customers.reports
- REST Resource: v1.customers.telemetry.devices
- REST Resource: v1.customers.telemetry.events
- REST Resource: v1.customers.telemetry.notificationConfigs
- REST Resource: v1.customers.telemetry.users
- REST Resource: v1.customers.thirdPartyProfileUsers
Service: chromemanagement.googleapis.com
To call this service, we recommend that you use the Google-provided client libraries . If your application needs to use your own libraries to call this service, use the following information when you make the API requests.
Discovery document
A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:
Service endpoint
A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:
-
https://chromemanagement.googleapis.com
REST Resource: v1alpha1.customers.profiles
| Methods | |
|---|---|
delete
|
DELETE /v1alpha1/{name=customers/*/profiles/*}
Deletes the data collected from a Chrome browser profile. |
get
|
GET /v1alpha1/{name=customers/*/profiles/*}
Gets a Chrome browser profile with customer ID and profile permanent ID. |
list
|
GET /v1alpha1/{parent=customers/*}/profiles
Lists Chrome browser profiles of a customer based on the given search and sorting criteria. |
REST Resource: v1alpha1.customers.telemetry.devices
| Methods | |
|---|---|
get
|
GET /v1alpha1/{name=customers/*/telemetry/devices/*}
Get telemetry device. |
list
|
GET /v1alpha1/{parent=customers/*}/telemetry/devices
List all telemetry devices. |
REST Resource: v1alpha1.customers.telemetry.events
| Methods | |
|---|---|
list
|
GET /v1alpha1/{parent=customers/*}/telemetry/events
List telemetry events. |
REST Resource: v1alpha1.customers.telemetry.notificationConfigs
| Methods | |
|---|---|
create
|
POST /v1alpha1/{parent=customers/*}/telemetry/notificationConfigs
Create a telemetry notification config. |
delete
|
DELETE /v1alpha1/{name=customers/*/telemetry/notificationConfigs/*}
Delete a telemetry notification config. |
list
|
GET /v1alpha1/{parent=customers/*}/telemetry/notificationConfigs
List all telemetry notification configs. |
patch
|
PATCH /v1alpha1/{telemetryNotificationConfig.name=customers/*/telemetry/notificationConfigs/*}
Update a telemetry notification config. |
REST Resource: v1alpha1.customers.telemetry.users
| Methods | |
|---|---|
get
|
GET /v1alpha1/{name=customers/*/telemetry/users/*}
Get telemetry user. |
list
|
GET /v1alpha1/{parent=customers/*}/telemetry/users
List all telemetry users. |
REST Resource: v1.customers.apps
| Methods | |
|---|---|
countChromeAppRequests
|
GET /v1/{customer=customers/*}/apps:countChromeAppRequests
Generate summary of app installation requests. |
fetchDevicesRequestingExtension
|
GET /v1/{customer=customers/*}/apps:fetchDevicesRequestingExtension
Get a list of devices that have requested to install an extension. |
fetchUsersRequestingExtension
|
GET /v1/{customer=customers/*}/apps:fetchUsersRequestingExtension
Get a list of users that have requested to install an extension. |
REST Resource: v1.customers.apps.android
| Methods | |
|---|---|
get
|
GET /v1/{name=customers/*/apps/android/*}
Get a specific app for a customer by its resource name. |
REST Resource: v1.customers.apps.chrome
| Methods | |
|---|---|
get
|
GET /v1/{name=customers/*/apps/chrome/*}
Get a specific app for a customer by its resource name. |
REST Resource: v1.customers.apps.web
| Methods | |
|---|---|
get
|
GET /v1/{name=customers/*/apps/web/*}
Get a specific app for a customer by its resource name. |
REST Resource: v1.customers.certificateProvisioningProcesses
| Methods | |
|---|---|
claim
|
POST /v1/{name=customers/*/certificateProvisioningProcesses/*}:claim
Claims a certificate provisioning process. |
get
|
GET /v1/{name=customers/*/certificateProvisioningProcesses/*}
Retrieves a certificate provisioning process. |
setFailure
|
POST /v1/{name=customers/*/certificateProvisioningProcesses/*}:setFailure
Marks a certificate provisioning process as failed. |
signData
|
POST /v1/{name=customers/*/certificateProvisioningProcesses/*}:signData
Requests the client that initiated a certificate provisioning process to sign data. |
uploadCertificate
|
POST /v1/{name=customers/*/certificateProvisioningProcesses/*}:uploadCertificate
Uploads a successfully issued certificate for a certificate provisioning process. |
REST Resource: v1.customers.certificateProvisioningProcesses.operations
| Methods | |
|---|---|
get
|
GET /v1/{name=customers/*/certificateProvisioningProcesses/*/operations/*}
Gets the latest state of a long-running operation. |
REST Resource: v1.customers.profiles
| Methods | |
|---|---|
delete
|
DELETE /v1/{name=customers/*/profiles/*}
Deletes the data collected from a Chrome browser profile. |
get
|
GET /v1/{name=customers/*/profiles/*}
Gets a Chrome browser profile with customer ID and profile permanent ID. |
list
|
GET /v1/{parent=customers/*}/profiles
Lists Chrome browser profiles of a customer based on the given search and sorting criteria. |
REST Resource: v1.customers.profiles.commands
| Methods | |
|---|---|
create
|
POST /v1/{parent=customers/*/profiles/*}/commands
Creates a Chrome browser profile remote command. |
get
|
GET /v1/{name=customers/*/profiles/*/commands/*}
Gets a Chrome browser profile remote command. |
list
|
GET /v1/{parent=customers/*/profiles/*}/commands
Lists remote commands of a Chrome browser profile. |
REST Resource: v1.customers.reports
| Methods | |
|---|---|
countActiveDevices
|
GET /v1/{customer=customers/*}/reports:countActiveDevices
Get a count of active devices per set time frames. |
countChromeBrowsersNeedingAttention
|
GET /v1/{customer=customers/*}/reports:countChromeBrowsersNeedingAttention
Count of Chrome Browsers that have been recently enrolled, have new policy to be synced, or have no recent activity. |
countChromeCrashEvents
|
GET /v1/{customer=customers/*}/reports:countChromeCrashEvents
Get a count of Chrome crash events. |
countChromeDevicesReachingAutoExpirationDate
|
GET /v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
Generate report of the number of devices expiring in each month of the selected time frame. |
countChromeDevicesThatNeedAttention
|
GET /v1/{customer=customers/*}/reports:countChromeDevicesThatNeedAttention
Counts of ChromeOS devices that have not synced policies or have lacked user activity in the past 28 days, are out of date, or are not complaint. |
countChromeHardwareFleetDevices
|
GET /v1/{customer=customers/*}/reports:countChromeHardwareFleetDevices
Counts of devices with a specific hardware specification from the requested hardware type (for example model name, processor type). |
countChromeVersions
|
GET /v1/{customer=customers/*}/reports:countChromeVersions
Generate report of installed Chrome versions. |
countDevicesPerBootType
|
GET /v1/{customer=customers/*}/reports:countDevicesPerBootType
Get a count of devices per boot type. |
countDevicesPerReleaseChannel
|
GET /v1/{customer=customers/*}/reports:countDevicesPerReleaseChannel
Get a count of devices per channel. |
countInstalledApps
|
GET /v1/{customer=customers/*}/reports:countInstalledApps
Generate report of app installations. |
countPrintJobsByPrinter
|
GET /v1/{customer=customers/*}/reports:countPrintJobsByPrinter
Get a summary of printing done by each printer. |
countPrintJobsByUser
|
GET /v1/{customer=customers/*}/reports:countPrintJobsByUser
Get a summary of printing done by each user. |
enumeratePrintJobs
|
GET /v1/{customer=customers/*}/reports:enumeratePrintJobs
Get a list of print jobs. |
findInstalledAppDevices
|
GET /v1/{customer=customers/*}/reports:findInstalledAppDevices
Generate report of managed Chrome browser devices that have a specified app installed. |
REST Resource: v1.customers.telemetry.devices
| Methods | |
|---|---|
get
|
GET /v1/{name=customers/*/telemetry/devices/*}
Get telemetry device. |
list
|
GET /v1/{parent=customers/*}/telemetry/devices
List all telemetry devices. |
REST Resource: v1.customers.telemetry.events
| Methods | |
|---|---|
list
|
GET /v1/{parent=customers/*}/telemetry/events
List telemetry events. |
REST Resource: v1.customers.telemetry.notificationConfigs
| Methods | |
|---|---|
create
|
POST /v1/{parent=customers/*}/telemetry/notificationConfigs
Create a telemetry notification config. |
delete
|
DELETE /v1/{name=customers/*/telemetry/notificationConfigs/*}
Delete a telemetry notification config. |
list
|
GET /v1/{parent=customers/*}/telemetry/notificationConfigs
List all telemetry notification configs. |
REST Resource: v1.customers.telemetry.users
| Methods | |
|---|---|
get
|
GET /v1/{name=customers/*/telemetry/users/*}
Get telemetry user. |
list
|
GET /v1/{parent=customers/*}/telemetry/users
List all telemetry users. |
REST Resource: v1.customers.thirdPartyProfileUsers
| Methods | |
|---|---|
move
|
POST /v1/{name=customers/*/thirdPartyProfileUsers/*}:move
Moves a third party chrome profile user to a destination OU. |


