> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://apidocs.polytomic.com/2023-04-25/configuring-your-connections/connections/google-workspace/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.polytomic.com/_mcp/server.

# Google Workspace

Supports:
* ✅ Models
* ✅ Bulk sync source
* ✅ Connection Proxy


## Connection

### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>auth_method</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Authentication method<br/><br/>Default: browser. Accepted values: `oauth`, `service_account` <a href="#auth-method-service-account">↓</a></td>
<td><code>required</code></td>
</tr>
<tr>
<td><code>client_id</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;"></td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>client_secret</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;"></td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>customer_id</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Customer ID</td>
<td><code>optional</code></td>
</tr>
</tbody>
</table>

<table>
<thead>
<tr>
<th>Read-only property</th><th>Type</th><th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>client_email</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Connected account<br/><br/>(required if `auth_method` is "service_account")</td>
</tr>
</tbody>
</table>

<a id="auth-method-service-account"></a>

#### `auth_method`

When `auth_method` is `service_account`:

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>service_account</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Service account key</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>

```json
{
  "name": "Google Workspace connection",
  "type": "googleworkspace",
  "configuration": {
    "auth_method": "service_account",
    "client_id": "eb669428-1854-4cb1-a560-403e05b8acbf",
    "client_secret": "ay8d5hdepz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
    "customer_id": "",
    "service_account": ""
  }
}
```


#### Example

```json
{
  "name": "Google Workspace connection",
  "type": "googleworkspace",
  "configuration": {
    "auth_method": "oauth",
    "client_id": "eb669428-1854-4cb1-a560-403e05b8acbf",
    "client_secret": "ay8d5hdepz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
    "customer_id": ""
  }
}
```


## Model Sync
### Source
#### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>stream_id</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Object</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>


#### Example
```json
{
  ...
  "configuration": {
    "stream_id": "directory_users"
  }
}
```







## Bulk Sync
### Source
Google Workspace connections may be used as a bulk sync source. No additional configuration options are required.