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

# Google Workspace

Learn how to connect Couchdrop to a Google Workspace account

## Overview

Couchdrop can connect to Google Workspace using a service account that Couchdrop creates for you.

Once connected, you can make Google Workspace Drive content available through Couchdrop and use it with Couchdrop file transfer and workflow features.

{% hint style="info" %}
To connect a personal Google Drive account instead, see [**Google Files (Individual Drive)**](/storage/integrations/google-files-individual-drive.md).
{% endhint %}

## How to connect Google Workspace

{% hint style="warning" %}

#### Before you start

To connect Google Workspace, you will need:

* A licensed Google Workspace account
* A folder in Google Drive
* Access to a Google Workspace Admin account
  {% endhint %}

{% stepper %}
{% step %}

### Add a new storage connection

In Couchdrop, add a new storage connection and select **Google Workspace** from the list of available connections.
{% endstep %}

{% step %}

### Configure Google Workspace

Enter a **Name for this integration** and select the **Couchdrop folder path** where the connection will appear.

Enter the following Google Workspace details:

* **Admin User** — Enter the email address of an administrator in the Google Workspace account.
* **Domain** — Enter the Google Workspace domain you want to connect.
* **Exclude 'SharedWithMe' Folders** — Enable this option if you want to exclude folders shared with the configured account. This setting is recommended.
  {% endstep %}

{% step %}

### Create the service account

Select **Create Service Account**.

Couchdrop will create the service account credentials required for the connection and generate a Client ID.

{% hint style="info" %}
Before testing the connection, you must delegate Domain-Wide Authority to the Couchdrop service account in the Google Workspace Admin Console.

If you need instructions for this process, see [**Delegating Domain-Wide Authority in Google Workspace**](/storage/integrations/google-workspace/delegating-domain-wide-authority-in-google-workspace.md).
{% endhint %}

After Domain-Wide Authority has been configured, select **Save and Test** to verify the Google Workspace connection.
{% endstep %}

{% step %}

### Map your storage folder

After the connection has been tested, you can optionally select a user or folder in Google Drive to use as the root location in Couchdrop. You can also manually enter a path.

Leaving this blank allows Couchdrop to map the Google Workspace connection directly without restricting it to a specific location.
{% endstep %}

{% step %}

### Save and use your Google Workspace connection

Optionally, configure **Transfer Shield** to surface or block unexpected, non-compliant, or malicious files uploaded through this connection.

When the configuration is complete, save the integration.
{% endstep %}
{% endstepper %}

## Frequently asked questions

<details>

<summary>Does Couchdrop create the Google Workspace service account?</summary>

Yes. Select **Create Service Account** and Couchdrop will create the required service account credentials and generate a Client ID.

</details>

<details>

<summary>Do I need to configure Domain-Wide Authority?</summary>

Yes. You must delegate Domain-Wide Authority to the Couchdrop service account in the Google Workspace Admin Console before testing the connection.

</details>

<details>

<summary>Do I have to select a user or folder?</summary>

No. Selecting a user or folder is optional.

After the connection has been successfully tested, you can select a location or manually enter a path if you want to restrict the connection to a specific root location.

</details>

<details>

<summary>What does Exclude 'SharedWithMe' Folders do?</summary>

This option excludes folders that have been shared with the configured Google Workspace account. Couchdrop recommends enabling this setting.

</details>

<details>

<summary>Can I connect a personal Google Drive account instead?</summary>

Yes. Use the [**Google Files (Individual Drive)**](/storage/integrations/google-files-individual-drive.md) connection for personal Google Drive accounts.

</details>


---

# 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.couchdrop.io/storage/integrations/google-workspace.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.