> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/connect-to-data/data-connections/google-cloud-storage.md).

# Google Cloud Storage

To set up a Google Cloud Storage connection, you need to specify the corresponding GCS bucket name. The Telmai service account must be granted access to the buckets requiring connections.

## Prerequisites

Before setting up the connection, identify which service account you will use:

* **Tenant service account**: Telmai's managed (or impersonated) service account. This is only available for GCP deployments. To find your specific tenant service account, open the **Create Connection** dialog and select **Google Cloud Storage**. The service account will be displayed on that page.
* **Your own service account**: if you prefer to provide your own credentials.

This service account must have the right permissions to access and read the data.

### Setting up permissions in Google Cloud Storage

1. Go to **Google Cloud Storage** and locate your bucket: `Google Cloud Storage / <bucket> / Permissions / Members`
2. Click **Add**.
3. In the **New Member** field, enter the service account identified in the prerequisites above.
4. Assign the following roles:
   1. `Storage Legacy Bucket Reader`
   2. `Storage Legacy Object Reader`
5. Click **Save** to apply the changes.

## Creating the connection in Telmai

GCS connections can be used to connect multiple data assets in Telmai using the same connection parameters. To add a GCS connection:

1. Navigate to the Telmai connection page and click the **+ Add Connection** button.
2. In the **Create Connection** dialog, select **Google Cloud Storage** as the Connection Type.
3. Enter a **Name** for the connection (required) and an optional **Description**.
4. Under **Properties**, enter the **Bucket** name (name only, not the full path).
5. Under **Credentials**, select one of the following:
   * **Use service account credentials** - provide your own service account key.
   * **Use tenant service account** - uses the Telmai-managed service account.
6. Click **Create**.

<figure><img src="/files/4fSp55eTtfqOlwBKrNlG" alt=""><figcaption></figcaption></figure>

## Connecting an asset

Once a connection is defined, you can start using it to create assets. To create assets, you will need:

* **Path**: Provide the full path of the file inside the bucket or the full path of the folder containing all files to be sent to Telmai. If specifying a folder, ensure all files have the same extension. Wildcards are accepted in this field.
* **File Type:** Please refer to [Supported File Types](/telmai/connect-to-data/supported-file-types.md).
* **Delimiter \[Optional]** : For CSV files, specify the delimiter (comma, tab, semicolon, space).

<figure><img src="/files/IMX95i09Z2UChRR2zGqT" alt=""><figcaption></figcaption></figure>