Google Drive

Sync Google Drive folders and files to Twig.

Overview

Property	Value
Type	Dynamic (OAuth 2.0)
Sync Schedule	Hourly, Daily, Weekly, Manual
Plan Availability	All plans
Supported Files	Google Docs, Sheets, Slides, PDF, DOCX, TXT, XLSX, PPTX
Max Files	1,000 per data source (configurable)

Use Cases

• Collaborative docs: Google Docs with multiple editors
• Team drives: Shared drives with department content
• Live documentation: Frequently updated content
• Workspace-native orgs: Companies using Google Workspace exclusively

Supported File Types

Google Workspace Files

• Google Docs (.gdoc) - Exported as HTML/text
• Google Sheets (.gsheet) - Exported as CSV/Excel
• Google Slides (.gslides) - Exported as PDF/PowerPoint
• Google Forms (.gform) - Form descriptions

Uploaded Files

• PDF (.pdf) - Portable Document Format
• Word (.doc, .docx) - Microsoft Word
• Excel (.xls, .xlsx) - Microsoft Excel
• PowerPoint (.ppt, .pptx) - Microsoft PowerPoint
• Text (.txt) - Plain text files
• Images (.jpg, .png, .gif) - Image files with text extraction

Setup Steps

1. Add Data Source

1. Twig → Data → Add Data Source → Google Drive
2. Fill:
   • Name: e.g., "Product Docs Folder"
   • Description: Optional
   • Tags: Optional

2. Authenticate

1. Click Connect Google Drive button
2. Redirected to Google OAuth screen
3. Select Google account
4. Review permissions:
   • Read-only access to Drive files
   • View file metadata
5. Click Allow
6. Redirected back to Twig

OAuth scopes requested:

• drive.readonly
• drive.metadata.readonly

Twig cannot: Modify, delete, or share your files

3. Select Scope

Option A: Entire Drive (not recommended)

• Imports all accessible files
• Can exceed file limits
• Slow processing

Option B: Specific Folder (recommended)

1. Click Select Folder button
2. Navigate to target folder
3. Click Select

Option C: Shared Drive

1. Toggle Include Shared Drives
2. Select shared drive from list
3. Optionally select folder within shared drive

Finding Folder ID:

• Open folder in browser
• Copy ID from URL: https://drive.google.com/drive/folders/1a2B3c4D5e6F7g8H9i0J
• ID is the alphanumeric string after /folders/

Step 5: Configure Sync Options

File Filters (JSON Parameters)

{
  "folderId": "abc123xyz",
  "includeSharedDrives": true,
  "fileTypes": ["doc", "sheet", "pdf"],
  "recursive": true,
  "includeShared": true,
  "maxFiles": 500
}

Available Parameters:

Parameter	Type	Description	Default
folderId	String	Specific folder ID to sync	Root
includeSharedDrives	Boolean	Include team/shared drives	true
fileTypes	Array	File types to include	All
recursive	Boolean	Include subfolders	true
includeShared	Boolean	Include files shared with you	true
maxFiles	Number	Maximum files to sync	1000
modifiedAfter	String	Only files modified after date	All

Step 6: Test Connection

1. Click Test Config or Test Connection
2. Twig will verify:
   • OAuth credentials are valid
   • Folder/drive is accessible
   • File permissions allow reading
3. Wait for "Connection Successful" message

Step 7: Set Refresh Schedule

Choose how often to sync changes:

• Never - Manual sync only
• Daily - Sync new/updated files daily (recommended)
• Weekly - Sync weekly
• Monthly - Sync monthly

Recommendation: Daily refresh for actively updated documentation

Step 8: Save and Sync

1. Click Save or Create
2. Initial sync begins automatically
3. Monitor progress in data sources list
4. Check process logs for any errors

Finding Google Drive Folder IDs

To sync a specific folder, you need its Folder ID.

Method 1: From URL

1. Open the folder in Google Drive

2. Look at the URL in your browser:

   https://drive.google.com/drive/folders/1a2B3c4D5e6F7g8H9i0J
                                          ^^^^^^^^^^^^^^^^^^^^
                                          This is the Folder ID
   

3. Copy the ID (everything after /folders/)

Method 2: From Folder Details

1. Right-click the folder in Google Drive
2. Select "Get link" or "Share"
3. Copy the link
4. Extract the ID from the URL

Configuration Examples

Example 1: Team Documentation Folder

Name: Engineering Documentation
Description: Technical docs and specifications
Authentication: OAuth (john@example.com)
Parameters:
{
  "folderId": "1a2B3c4D5e6F7g8H9i0J",
  "recursive": true,
  "fileTypes": ["doc", "sheet", "pdf"],
  "includeShared": true
}
Refresh: Daily
Tags: engineering, docs, internal

Example 2: Shared Team Drive

Name: Product Team Drive
Description: Complete product team shared drive
Authentication: OAuth (team@example.com)
Parameters:
{
  "includeSharedDrives": true,
  "recursive": true,
  "maxFiles": 500
}
Refresh: Daily
Tags: product, team-drive, shared

Example 3: Specific File Types

Name: Product Specifications
Description: Product spec documents only
Authentication: OAuth (pm@example.com)
Parameters:
{
  "folderId": "xyz789abc",
  "fileTypes": ["doc"],
  "recursive": false,
  "includeShared": false
}
Refresh: Weekly
Tags: product, specs, documents

Best Practices

1. Use Service Accounts (Enterprise)

For enterprise deployments:

• Create a dedicated Google Workspace service account
• Grant read-only access to relevant folders
• Use consistent authentication across team
• Easier to manage and audit

2. Organize with Folders

Structure your Google Drive for easy syncing:

📁 Company Knowledge Base/
  📁 Product Documentation/
  📁 Support Articles/
  📁 Training Materials/
  📁 Technical Specs/

Sync each folder as a separate data source in Twig.

3. Use Appropriate File Types

Best for AI:

• Google Docs (clean, structured text)
• Google Sheets (structured data)
• PDF (formatted documents)
• Text files (simple content)

Less Optimal:

• Images (unless text is clearly readable)
• Zip files (extract first)
• Compressed formats

4. Keep Folder Structure Flat

Good:

📁 Documentation/
  📄 Getting Started.gdoc
  📄 API Reference.gdoc
  📄 Tutorials.gdoc

Avoid:

📁 Documentation/
  📁 Section A/
    📁 Subsection 1/
      📁 Sub-subsection a/
        📄 Document.gdoc (too deep)

5. Set Appropriate Permissions

Ensure the authenticated account has:

• Viewer or Editor access to folders
• Access to shared files
• Appropriate shared drive permissions

6. Limit Scope for Performance

Rather than syncing entire Drive:

{
  "folderId": "specific-folder-id",
  "recursive": true,
  "maxFiles": 500
}

7. Monitor File Count

Large numbers of files can:

• Slow down syncs
• Impact processing time
• Increase storage usage

Split large folders into multiple data sources.

Understanding Sync Behavior

Initial Sync

• Imports all files in selected scope
• May take time for large folders
• Processes files in batches

Incremental Syncs

• Detects files modified since last sync
• Imports only new/changed files
• Much faster than initial sync

What Gets Synced

• ✅ New files added to folder
• ✅ Modified file content
• ✅ Renamed files (as new files)
• ✅ Moved files into synced folder
• ❌ Files moved out of folder (remain until manual cleanup)
• ❌ Deleted files (remain until manual cleanup)
• ❌ Private files (no access)
• ❌ Files in trash

File Conversion

Google Workspace files are automatically converted:

• Google Docs → Plain text/HTML
• Google Sheets → CSV data
• Google Slides → Text from slides
• Google Forms → Form structure and questions

Permissions & Security

OAuth Scopes Required

Twig requests these permissions:

• drive.readonly - Read-only access to files
• drive.metadata.readonly - File metadata and organization

Twig cannot:

• Modify your files
• Delete your files
• Share your files
• Create new files

Data Privacy

• Files are processed and indexed securely
• Original files remain in your Google Drive
• Connection tokens are encrypted
• You can revoke access anytime

Revoking Access

To disconnect Google Drive:

1. In Twig: Delete the data source
2. In Google: Visit Google Account Permissions
3. Find "Twig AI" and click Remove Access

Troubleshooting

Authentication Failed

Problem: Can't connect Google Drive

Solutions:

• Ensure you're using correct Google account
• Check if admin has blocked third-party apps
• Try signing out and back into Google
• Clear browser cookies and try again
• Check if Google Drive API is enabled for workspace

No Files Found

Problem: Sync completes but no files imported

Solutions:

• Verify folder ID is correct
• Check authenticated account has access to folder
• Ensure folder contains supported file types
• Review file type filters in parameters
• Check maxFiles limit isn't too restrictive

Permission Denied Errors

Problem: Some files fail to sync

Solutions:

• Verify account has access to all files
• Check if files are in trash
• Ensure shared drive access if applicable
• Review file-level permissions
• Look for files in "Shared with me" needing explicit access

Slow Syncs

Problem: Syncs take very long time

Solutions:

• Reduce maxFiles limit
• Disable recursive if not needed
• Filter by specific fileTypes
• Split large folders into multiple sources
• Check Google Drive API quota

Missing Recent Changes

Problem: Recent file updates not appearing

Solutions:

• Check last sync date
• Manually trigger refresh
• Verify refresh schedule is appropriate
• Look for sync errors in process logs
• Check if file modification date updated in Drive

Shared Drive Issues

Problem: Can't access shared/team drives

Solutions:

• Ensure account is member of shared drive
• Verify includeSharedDrives: true in parameters
• Check shared drive permissions
• Confirm shared drive hasn't been deleted
• Try re-authenticating

Advanced Configuration

Syncing Multiple Folders

Create separate data sources for each folder:

// Source 1: Engineering Docs
{
  "folderId": "abc123",
  "fileTypes": ["doc", "pdf"]
}

// Source 2: Product Specs
{
  "folderId": "xyz789",
  "fileTypes": ["doc", "sheet"]
}

Date-Based Filtering

Import only recent files:

{
  "modifiedAfter": "2024-01-01",
  "maxFiles": 200
}

Excluding Specific Files

While not directly supported, you can:

1. Move excluded files to a different folder
2. Use specific folder IDs to include only desired content
3. Filter by file type to exclude unwanted formats

Monitoring & Maintenance

Regular Checks

Weekly:

• Verify last sync completed
• Check file count trends
• Review process logs

Monthly:

• Audit synced folders
• Remove outdated sources
• Update folder selections

Metrics to Track

• Files Synced: Total number of files
• Last Sync Date: When was last successful sync
• Sync Duration: Time taken for sync
• Error Count: Failed file imports
• Storage Used: Data indexed from Drive

Integration Best Practices

1. Create AI Agents per Team

Agent: Engineering Assistant
Data Sources: Engineering Docs folder

Agent: Product Assistant  
Data Sources: Product Specs folder

2. Use Tags for Organization

Tag data sources by:

• Department: "engineering", "product", "marketing"
• Content type: "docs", "specs", "presentations"
• Access level: "internal", "public", "confidential"

3. Combine with Other Sources

Create comprehensive knowledge bases:

• Google Drive: Living documents
• Confluence: Structured wikis
• Slack: Team discussions
• Files: Legacy documents

Next Steps

After connecting Google Drive:

1. Test the knowledge with document-based questions
2. Create team-specific agents
3. Monitor which documents are most referenced
4. Optimize folder structure based on usage
5. Expand to additional folders as needed

Related Connectors

• Microsoft OneDrive - Microsoft cloud storage
• Microsoft SharePoint - SharePoint sites
• Confluence - Wiki-based knowledge
• Files - Direct file uploads
• Slack - Team discussions

Support

For Google Drive API issues:

• Google Drive API Documentation: https://developers.google.com/drive
• Google Workspace Admin Console: https://admin.google.com
• Check API quotas and limits

For Twig integration issues:

• Review process logs in Twig
• Contact Twig support with specific file IDs
• Share folder structure if troubleshooting access issues

---

Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the ask query parameter:

GET /dev/product/data-integrations/google-drive.md?ask=<question>

The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.