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

# Google Drive

> Use Google Docs, Sheets, and Slides from Google Drive as knowledge sources for your AI chatbot

Transform your Google Drive into an intelligent knowledge base. Connect documents, spreadsheets, and presentations to provide instant answers from content you already maintain.

## Why Connect Google Drive?

<CardGroup cols={2}>
  <Card title="Three File Types" icon="file">
    Sync Docs, Sheets, and Slides in one integration
  </Card>

  <Card title="Auto-Sync" icon="refresh">
    Changed files are automatically re-synced each cycle
  </Card>

  <Card title="Semantic Search" icon="magnifying-glass">
    AI understands context and meaning, not just keywords
  </Card>

  <Card title="Read-Only Access" icon="lock">
    OAuth 2.0 with read-only scopes — your files are never modified
  </Card>
</CardGroup>

## Prerequisites

* A Google account with Docs, Sheets, or Slides files you want to use as knowledge
* A BubblaV website with an active subscription

## Setup Steps

<Steps>
  <Step title="Navigate to Integrations">
    Go to **Dashboard** → **Integrations** → **Google Drive**
  </Step>

  <Step title="Connect Google Account">
    Click **Connect Google Drive** and authorize via Google
  </Step>

  <Step title="Add Files">
    Click **Add Files** to browse your Google Drive and select files to sync
  </Step>
</Steps>

***

## Supported File Types

| Type          | Google MIME Type                           | Export Format         |
| ------------- | ------------------------------------------ | --------------------- |
| Google Docs   | `application/vnd.google-apps.document`     | Plain text            |
| Google Sheets | `application/vnd.google-apps.spreadsheet`  | CSV                   |
| Google Slides | `application/vnd.google-apps.presentation` | Text (via Slides API) |

## Content Syncing

Google Drive content is synced automatically according to your plan's crawl frequency:

* **Free**: No automatic syncing
* **Pro**: Weekly
* **Turbo**: Daily

## Sync Status

Each file shows one of four statuses:

| Status    | Meaning                               |
| --------- | ------------------------------------- |
| `Pending` | Added but not yet synced              |
| `Syncing` | Currently being processed             |
| `Synced`  | Successfully synced to knowledge base |
| `Failed`  | Error during sync — hover for details |

## Permissions Required

BubblaV requests the following read-only Google OAuth scopes:

* `drive.readonly` — List and read files from Google Drive
* `documents.readonly` — Read Google Docs content

## Troubleshooting

<AccordionGroup>
  <Accordion title="Files not appearing in browser">
    Only Google Drive files (Docs, Sheets, and Slides) are shown. Other file types (PDFs, images, etc.) are not supported. Make sure you're viewing the correct Google account.
  </Accordion>

  <Accordion title="Sync status stuck on 'Syncing'">
    Refresh the page. It takes a few minutes to sync.
  </Accordion>

  <Accordion title="Large spreadsheets returning incomplete data">
    Only the first sheet of a spreadsheet is synced. For large sheets, only the first exported CSV is processed. Consider splitting data across multiple sheets or files.
  </Accordion>
</AccordionGroup>