# Google Workspace (Gsuite)

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.

***

### Prerequisites

<table><thead><tr><th width="249">Item</th><th>Description</th></tr></thead><tbody><tr><td><strong>Apono Premium</strong></td><td><a href="https://www.apono.io/pricing/">Apono plan</a> providing the most features and dedicated account support</td></tr><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. (Optional) Enter the **Custom Manager Field Name**.

{% hint style="info" %}
By specifying the manager attribute name in this field, Apono can locate a user's manager within Google Workspace. If the attribute name is not specified, Apono uses Google Workspace's predefined field, **Manager's Email** in the **Employee information** section of the [user's profile](https://support.google.com/a/answer/6191788?hl=en\&sjid=3496568741447857656-NC#individual)**.**

You can also use [custom attributes](https://support.google.com/a/answer/6208725?hl=en) to specify a user's manager.

**The manager attribute must contain either the manager's email address or Google Workspace user ID.**
{% endhint %}

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**.