> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bondata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Cloud Storage

> Connect BonData to Google Cloud Storage buckets

## GCS Connection Setup

Follow these steps to connect BonData to your Google Cloud Storage bucket.

### Step 1: Create a Service Account

1. Go to the [GCP Console](https://console.cloud.google.com/iam-admin/serviceaccounts)
2. Select your project
3. Click **Create Service Account**
4. Enter a name (e.g., `bondata-gcs-access`)
5. Click **Create and Continue**

### Step 2: Assign Storage Permissions

<Tabs>
  <Tab title="Specific Bucket (Recommended)">
    1. Skip the optional grant step and click **Done**
    2. Go to [Cloud Storage](https://console.cloud.google.com/storage/browser)
    3. Click your bucket → **Permissions** tab
    4. Click **Grant Access**
    5. Enter the service account email
    6. Assign the role **Storage Object Viewer** (`roles/storage.objectViewer`)
    7. Click **Save**
  </Tab>

  <Tab title="Full Project Access">
    1. In the **Grant this service account access to project** step, add the role **Storage Object Viewer** (`roles/storage.objectViewer`)
    2. Click **Continue** → **Done**
  </Tab>
</Tabs>

<Note>
  For write access, use the **Storage Object Admin** role instead.
</Note>

### Step 3: Create a JSON Key

1. Go to [Service Accounts](https://console.cloud.google.com/iam-admin/serviceaccounts)
2. Click your service account
3. Go to the **Keys** tab
4. Click **Add Key** → **Create new key**
5. Select **JSON** and click **Create**
6. The key file will download automatically - keep it safe

### Step 4: Enter Credentials

Upload the JSON key file in BonData.

## Required Fields

| Field               | Description                                |
| ------------------- | ------------------------------------------ |
| Bucket Name         | The name of the GCS bucket                 |
| Prefix              | Optional folder path (e.g., data/exports)  |
| Project ID          | The Google Cloud project ID (optional)     |
| Service Account Key | The JSON key file for your service account |