The Connectors API allows administrators to inspect and manage connector
configurations for real-time reporting, security insights, and data integration
across managed Chrome browsers and profiles.

## Quick overview of API methods

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

| Description | Relative URL | Http method |
|---|---|---|
| List connector configurations | [/connectorConfigs](https://developers.google.com/chrome/management/reference/rest/v1/customers.connectorConfigs/list) | GET |
| Get a connector configuration | [/connectorConfigs/{connectorConfig}](https://developers.google.com/chrome/management/reference/rest/v1/customers.connectorConfigs/get) | GET |
| Create a connector configuration | [/connectorConfigs](https://developers.google.com/chrome/management/reference/rest/v1/customers.connectorConfigs/create) | POST |
| Update a connector configuration | [/connectorConfigs/{connectorConfig}](https://developers.google.com/chrome/management/reference/rest/v1/customers.connectorConfigs/patch) | PATCH |
| Delete a connector configuration | [/connectorConfigs/{connectorConfig}](https://developers.google.com/chrome/management/reference/rest/v1/customers.connectorConfigs/delete) | DELETE |

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

## Subscription requirements

All Connectors API methods require an active **Chrome Enterprise Core (CEC)** subscription.

## Admin Privileges

Depending on which method is being invoked, different administrator privileges
are required.

| Method | Admin privileges required |
|---|---|
| list | "Services -\> Chrome Management -\> Settings -\> Manage User Settings" or "Services -\> Chrome Management -\> Settings -\> Manage User Settings -\> Read" or "Services -\> Chrome Management -\> Settings -\> Manage Device Settings" or "Services -\> Chrome Management -\> Settings -\> Manage Device Settings -\> Read" |
| get | "Services -\> Chrome Management -\> Settings -\> Manage User Settings" or "Services -\> Chrome Management -\> Settings -\> Manage User Settings -\> Read" or "Services -\> Chrome Management -\> Settings -\> Manage Device Settings" or "Services -\> Chrome Management -\> Settings -\> Manage Device Settings -\> Read" |
| create | "Services -\> Chrome Management -\> Settings -\> Manage User Settings" or "Services -\> Chrome Management -\> Settings -\> Manage Device Settings" |
| patch | "Services -\> Chrome Management -\> Settings -\> Manage User Settings" or "Services -\> Chrome Management -\> Settings -\> Manage Device Settings" |
| delete | "Services -\> Chrome Management -\> Settings -\> Manage User Settings" or "Services -\> Chrome Management -\> Settings -\> Manage Device Settings" |

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

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

## API scopes

Chrome Management Connectors API requires the following OAuth scopes:

| Method | OAuth scopes required |
|---|---|
| list | https://www.googleapis.com/auth/chrome.management.connectors or https://www.googleapis.com/auth/chrome.management.connectors.readonly |
| get | https://www.googleapis.com/auth/chrome.management.connectors or https://www.googleapis.com/auth/chrome.management.connectors.readonly |
| create | https://www.googleapis.com/auth/chrome.management.connectors |
| patch | https://www.googleapis.com/auth/chrome.management.connectors |
| delete | https://www.googleapis.com/auth/chrome.management.connectors |

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