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.
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
- Navigate to the Google Drive sync page
- Click Sync Now
- Wait for the sync to complete
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
Editing a Sync Mapping
- Find the mapping in the list
- Click Edit
- Update the source folder, destination path, or options
- Click Save
Removing a Sync Mapping
- Find the mapping in the list
- Click Delete
- Confirm the action
Disconnecting Google Drive
- Navigate to Settings > Integrations > Google Drive
- Click Disconnect
- Confirm the action
How Sync Works
| Step | What Happens |
|---|---|
| Change detection | Compares modification time and MD5 checksum against last sync |
| Conflict resolution | Google Drive version wins — local copies are overwritten if they differ |
| New files | Downloaded from Google Drive and created in the Data Room |
| Updated files | Re-downloaded and replace the existing version |
| Deleted files | Not automatically removed from the Data Room (sync is additive) |
Tips
Troubleshooting
Google Drive connection failed
Google Drive connection failed
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.
Sync is not detecting new files
Sync is not detecting new files
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.
Some files were not synced
Some files were not synced
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.
I need to re-authorize after a while
I need to re-authorize after a while