Skip to main content

Google Drive Sync

This page covers the Equa platform’s Data Room sync feature. For agent-level Google Drive tools (list, search, upload, download, mkdir via MCP), see Google Drive MCP.
Google Drive Sync lets you connect your Google account and automatically synchronize files from specific Google Drive folders into your Equa Data Room. This eliminates manual uploads for teams that already use Google Drive as their document store.

Prerequisites

  • Active Equa account with organization admin permissions
  • A Google account with files you want to sync
  • Google Drive integration enabled for your organization

Connecting Google Drive

Step 1: Navigate to Google Drive Settings

From your organization sidebar, click Settings > Integrations > Google Drive, or navigate to the Google Drive sync page.

Step 2: Authorize Equa

Click Connect Google Drive. You will be redirected to Google’s authorization page.

Step 3: Grant Permission

Sign in to your Google account and grant Equa read-only access to your Google Drive. The platform requests only the minimum permissions needed:
  • Read files — To download file contents for sync
  • Read metadata — To detect changes and track file versions

Step 4: Confirm Connection

After authorizing, you are redirected back to Equa. The connection status will show as “Connected” with your Google account name.

Configuring Folder Sync

Step 1: Add a Sync Mapping

Click Add Folder Mapping to create a new sync rule.

Step 2: Select the Source Folder

Use the Google Drive folder browser to navigate and select the folder you want to sync from.

Step 3: Set the Destination Path

Enter the Data Room path where synced files should appear (e.g., /Google Drive/Financials).

Step 4: Configure Options

  • Sync subfolders — Toggle on to include all subfolders within the source folder
  • File type filter (optional) — Specify which file types to include or exclude by MIME type

Step 5: Save the Configuration

Click Save. The mapping is saved and ready for sync.

Common Tasks

Running a Manual Sync

  1. Navigate to the Google Drive sync page
  2. Click Sync Now
  3. Wait for the sync to complete
The system compares your Google Drive files with the last-synced versions using modification timestamps and file checksums. Only changed files are downloaded.

Reviewing Sync History

Each sync run is recorded with:
  • Sync timestamp
  • Number of files synced
  • Number of files added, updated, or skipped
  • Any errors encountered
View the history on the Google Drive sync page.

Editing a Sync Mapping

  1. Find the mapping in the list
  2. Click Edit
  3. Update the source folder, destination path, or options
  4. Click Save

Removing a Sync Mapping

  1. Find the mapping in the list
  2. Click Delete
  3. Confirm the action
Removing a mapping stops future syncs but does not delete files already synced to the Data Room.

Disconnecting Google Drive

  1. Navigate to Settings > Integrations > Google Drive
  2. Click Disconnect
  3. Confirm the action
This revokes Equa’s access to your Google Drive. Existing synced files remain in the Data Room.

How Sync Works

StepWhat Happens
Change detectionCompares modification time and MD5 checksum against last sync
Conflict resolutionGoogle Drive version wins — local copies are overwritten if they differ
New filesDownloaded from Google Drive and created in the Data Room
Updated filesRe-downloaded and replace the existing version
Deleted filesNot automatically removed from the Data Room (sync is additive)

Tips

Equa requests read-only access to your Google Drive. It cannot modify, delete, or create files in your Google Drive account.
Set up sync mappings for your most important folders (e.g., legal documents, financial statements, board materials). This ensures your Data Room always has the latest versions.
Access tokens are automatically refreshed when they expire. You should not need to re-authorize unless you revoke access from your Google account settings.

Troubleshooting

Cause: The authorization flow may have been interrupted, or your browser may have blocked the redirect.Solution: Try again, making sure to complete the full authorization flow. Allow pop-ups for app.equa.cc in your browser settings.
Cause: The sync compares modification timestamps. If files were added to a folder that is not included in your sync mapping, they will not be detected.Solution: Check that your sync mapping covers the correct Google Drive folder. If you enabled subfolder sync, make sure the new files are within the mapped folder hierarchy.
Cause: File type filters may be excluding certain file types, or there may have been errors during download.Solution: Check the sync history for error details. Review the file type filter settings on the sync mapping.
Cause: The refresh token may have been revoked from your Google account, or the token may have expired without successful refresh.Solution: Disconnect and reconnect Google Drive from the integration settings. This generates a fresh authorization.