> 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

Connect Telmai to Google Cloud Storage.

Telmai reads files from a Google Cloud Storage bucket with a Google Cloud service account.

## Before you connect

Choose the service account Telmai uses:

* **Tenant service account**: Telmai's own service account, on GCP deployments only. To see it, start a Google Cloud Storage connection. The form shows it under **Credentials**, next to **Using service account:**.
* **Your own service account**: create a [service account key](https://cloud.google.com/iam/docs/keys-create-delete) in JSON format.

On hybrid deployments, the account that reads your data is the service account in your hybrid agent, so grant the roles to that account.

On the bucket, grant the service account `Storage Object Viewer` (`roles/storage.objectViewer`) and `Storage Legacy Bucket Reader` (`roles/storage.legacyBucketReader`). In the Google Cloud console, open the bucket, go to the **Permissions** tab and click **Grant access**. See [Add a principal to a bucket-level policy](https://cloud.google.com/storage/docs/access-control/using-iam-permissions#bucket-add).

## Connection fields

On the **Connections** page, click **Add connection** and choose **Google Cloud Storage**. See [Add a connection](https://docs.telm.ai/telmai/connect-to-data.md#add-a-connection) for the full flow.

| Field                                                                                | Description                                                                                                             |
| ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| **Bucket**                                                                           | The bucket name only, not a path, for example `your-bucket`.                                                            |
| **Client email**, **Client ID**, **Project ID**, **Private key ID**, **Private key** | Your own service account's details, from its JSON key. Click **Import credentials** to fill them in from the JSON file. |

On GCP deployments with a tenant service account, Telmai uses that account and there are no credentials to fill in.

## Asset fields

Click **Add assets** on the connection. See [Add assets](https://docs.telm.ai/telmai/connect-to-data.md#list-of-connectors-enabled-by-default).

| Field                                      | Description                                                                                                                                                               |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Path**                                   | The path of a file in the bucket, or of a folder whose files all have the same format, for example `sales/2026/orders.csv` or `sales/2026/`. Wildcards (`*`) are allowed. |
| **File type**                              | **Automatic**, or the file format.                                                                                                                                        |
| **Delimiter**                              | For CSV files, **Automatic** or **Comma**, **Semicolon**, **Tab**, **Space** or **Pipe**.                                                                                 |
| **Resolve wildcards (\*) to folder names** | Check it when a wildcard in **Path** should match folders, for example `sales/*/orders.csv`.                                                                              |

For paths, wildcards and file types, see [File Path Options](https://docs.telm.ai/telmai/connect-to-data/file-path-options.md) and [Supported File Types](https://docs.telm.ai/telmai/connect-to-data/supported-file-types.md).
