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
- Google OAuth credentials configured in your environment (
GOOGLE_CLIENT_ID,GOOGLE_CLIENT_SECRET)
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
- Starter: Monthly
- Pro: Weekly
- Turbo: Daily
Incremental Syncing
The integration tracks themodifiedTime from the Google Drive API:
- Only files modified since the last sync are re-processed
- Unchanged files are skipped to save resources
- Force sync is available via the manual Sync button
File Selection
Unlike Notion which auto-discovers pages, Google Drive requires explicit file selection:- Click Add Files to open the file browser
- Search by name or filter by type (Docs / Sheets / Slides)
- Click Add next to files you want to include
- Files appear in your knowledge sources list with sync status
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 contentspreadsheets.readonly— Read Google Sheets datapresentations.readonly— Read Google Slides content
Troubleshooting
'Token expired' error
'Token expired' error
Your Google OAuth token has expired or been revoked. Go to Integrations → Google Drive and click Connect Google Drive to re-authorize.
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. If the status remains, click Sync to trigger a fresh sync cycle.
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.