Why Connect Google Drive?
Three File Types
Sync Docs, Sheets, and Slides in one integration
Auto-Sync
Changed files are automatically re-synced each cycle
Semantic Search
AI understands context and meaning, not just keywords
Read-Only Access
OAuth 2.0 with read-only scopes — your files are never modified
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
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 Drivedocuments.readonly— Read Google Docs content
Troubleshooting
Files not appearing in browser
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.
Sync status stuck on 'Syncing'
Sync status stuck on 'Syncing'
Refresh the page. It takes a few minutes to sync.
Large spreadsheets returning incomplete data
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.