> For the complete documentation index, see [llms.txt](https://docs.apono.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apono.io/docs/additional-integrations/identity-providers/google-workspace-gsuite.md).

# Google Workspace (Gsuite)

Create an integration to manage access to your Google Workspace

Google Workspace (Gsuite) provides a unified platform for communication, file sharing, and collaboration within an organization.

Through this integration, Apono automatically syncs your organizational users and groups when integrating with an organizational identity provider.

***

### Prerequisite

<table><thead><tr><th width="249">Item</th><th>Description</th></tr></thead><tbody><tr><td><strong>Google User Account</strong></td><td><p>Google user account with the following admin API privileges:</p><ul><li><strong>Users: Read</strong></li><li><strong>Groups: Read</strong></li></ul></td></tr></tbody></table>

***

### Integrate Google Workspace

<figure><img src="https://1094436629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv6MBfUGvblSdAz31yJXm%2Fuploads%2Fgit-blob-f937cf832b9f4586c1ccc170062153e3cd80489f%2Fimage%20(18).png?alt=media" alt="" width="464"><figcaption><p>Google Workspace tile</p></figcaption></figure>

Follow these steps to complete the integration:

1. On the [**Catalog**](https://app.apono.io/catalog?search=google-idp) tab, click **Google Workspace**. The **Add Integration** page appears.
2. Define the integration settings.

<table><thead><tr><th width="210.4088134765625">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Custom Manager Field Name</strong></td><td><p>(Optional) Specifies the attribute Apono uses to identify a user’s manager in Google Workspace</p><p>If the attribute name is not specified, Apono uses Google Workspace's predefined field, <strong>Manager's Email</strong> in the <strong>Employee information</strong> section of the <a href="https://support.google.com/a/answer/6191788?hl=en&#x26;sjid=3496568741447857656-NC#individual">user's profile</a>.</p><p>You can also use <a href="https://support.google.com/a/answer/6208725?hl=en">custom attributes</a> to specify a user's manager.</p><p><strong>IMPORTANT</strong>: The manager attribute must contain either the manager's email address or Google Workspace user ID.</p></td></tr><tr><td><strong>Use Recovery Email as Alias</strong></td><td>Determines whether Apono can recognize users by an additional email address stored in Google Workspace, such as a recovery email</td></tr><tr><td><strong>Groups to Sync</strong></td><td><p>(Optional) Limits synchronization to a specified comma-separated list of Google Workspace groups and their users</p><p>If no groups are specified, Apono syncs all groups and associated users.</p></td></tr></tbody></table>

3. Click **Connect**. The Google sign in prompts appears.
4. Follow the sign in prompts.

{% hint style="warning" %}
Be sure that the account you connect has the following admin API privileges:

* **Users: Read**
* **Groups: Read**
  {% endhint %}

5. On the **Apono wants additional access to your Google Account** page, click **Select all**.
6. Click **Continue**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.apono.io/docs/additional-integrations/identity-providers/google-workspace-gsuite.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.