Google Drive Connector

Google Drive Connector

Sync files from Google Drive including native Google Docs, Sheets, Slides, and uploaded files.

Features

• Google Docs - Exported as text with formatting preserved
• Google Sheets - Exported as CSV data
• Google Slides - Exported as text content
• PDFs, Office docs - Processed directly
• Incremental sync - Only changed files re-indexed
• Shared drives - Full support for team drives
• Folder filtering - Sync specific folders only

Prerequisites

1. A Google Cloud project with Drive API enabled
2. OAuth credentials configured
3. Admin access (for organization-wide sync)

Setup

Step 1: Connect via OAuth

1. Go to Settings > Integrations
2. Find Google Drive and click Connect
3. Sign in with your Google account
4. Grant the requested permissions:

- drive.readonly - Read file content

- drive.metadata.readonly - Read file metadata

Step 2: Configure Sync Settings

After connecting, configure what to sync:

client.connectors.configure("google_drive", {
    "settings": {
        "folder_id": "optional-root-folder-id",  # Limit to folder
        "include_shared": True,                   # Include shared files
        "file_types": ["document", "spreadsheet", "pdf", "text"]
    }
})

Available file types:

• document - Google Docs, .docx, .doc
• spreadsheet - Google Sheets, .xlsx, .xls, .csv
• presentation - Google Slides, .pptx, .ppt
• pdf - PDF files
• text - .txt, .md, .html

Step 3: Start Initial Sync

# Trigger first full sync
client.connectors.sync("google_drive", mode="full")

API Reference

List Files

GET /api/connectors/{connector_id}/files?limit=50

# Response
{
  "files": [
    {
      "id": "file_abc123",
      "external_id": "1BxiMVs0XRA5nFMdKvBd...",
      "name": "Q4 Report",
      "mime_type": "application/vnd.google-apps.document",
      "modified_time": "2026-01-20T10:30:00Z",
      "synced": true
    }
  ]
}

Trigger Sync

POST /api/connectors/{connector_id}/sync
{
  "mode": "incremental"
}

Supported MIME Types

Permissions

Google Drive permissions are respected:

• Files shared with the authenticated user are accessible
• Shared drive membership determines access
• Permission changes sync within 1 hour

Sync Frequency

Troubleshooting

"Access denied" errors

• Verify the file is shared with the connected account
• Check OAuth scopes include drive.readonly

Missing files

• Verify file type is in the configured file_types
• Check folder filter isn't excluding the file

Stale content

• Trigger manual sync: POST /api/connectors/{id}/sync
• Check sync status for errors

Next Steps

• Notion Connector - Connect Notion
• Integrations Overview - Architecture overview