Connecting Google Drive to Knowledge Management
The Google Drive knowledge integration syncs documents from your Google Shared Drives into the Rezolve.ai Knowledge Base. The Virtual Agent can then use them to answer questions and link back to the file in Google Drive.
This page covers the Google Drive-specific setup. For the wizard, sync status, bounced files, and other functions that all integrations share, see Knowledge Integrations.
Only Shared Drives are supported. Files in a user's My Drive or Shared with me can't be synced. Move them to a Shared Drive first.
Prerequisites
- A Google Workspace account with Shared Drives.
- Access to a Google Cloud project where you can enable APIs and create a service account.
- Permission to add members to the Shared Drives you want to sync, as a Shared Drive manager.
- Knowledge Management admin access in the Rezolve.ai console.
Step 1: Create a service account
- In the Google Cloud console, select or create a project.
- Go to APIs & Services → Library, search for Google Drive API, and click Enable.
- Go to IAM & Admin → Service Accounts → + Create service account. Enter a name, for example
rezolve-kb-sync, and click Done. It doesn't need any project roles. - Open the service account, go to Keys → Add key → Create new key, choose JSON, and click Create. Store the downloaded key file securely.
From the JSON key file, you'll need:
| JSON key | Rezolve.ai field |
|---|---|
client_email | Service Account Email |
token_uri | Token URI (normally https://oauth2.googleapis.com/token) |
private_key | Private Key, including the -----BEGIN PRIVATE KEY----- and -----END PRIVATE KEY----- lines |
Domain-wide delegation is not needed. The service account reads only the Shared Drives it's a member of.
Step 2: Give the service account access to your Shared Drives
For each Shared Drive you want to sync:
- In Google Drive, open the Shared Drive and click Manage members.
- Add the service account's email address, for example
rezolve-kb-sync@my-project.iam.gserviceaccount.com. - Give it the Viewer role, then click Send. If your organization blocks sharing with external addresses, allow it first.
Step 3: Create the Google Drive integration
- In the Rezolve.ai console, go to Knowledge Management → Knowledge Integrations.
- Click Add Integrations and select Google Drive.
3a. Connection setup
Enter a Title for the integration. Then either choose an existing Google Drive connection or select Create New Connection and enter these details:
| Field | Description | Example |
|---|---|---|
| Name | A descriptive name for the connection | Company Shared Drives |
| Service Account Email | client_email from the key file | rezolve-kb-sync@my-project.iam.gserviceaccount.com |
| Token URI | token_uri from the key file | https://oauth2.googleapis.com/token |
| Private Key | private_key from the key file | -----BEGIN PRIVATE KEY-----... |
3b. Content selection
Content is organized into one or more content sets. In each content set:
- Browse the Shared Drives the service account can access.
- Tick a whole drive, or expand it and tick specific folders.
- Selections are crawled recursively, including all sub-folders.
- A folder inside a ticked drive is already covered.
- To limit who can get answers from this content set, open the ⋮ menu, turn on Restrict Access, and choose Restrict by Audience.
3c. Configuration
Under Sync Details, set the Frequency (daily, weekly, or monthly), Start Time, Timezone, and Schedule Start Date. Optionally turn on Subscribe to Sync Reports and add User Subscribers. Then click Save.
What gets ingested
| File type | Handling |
|---|---|
| Google Docs | Exported as PDF, including images |
| Google Slides | Exported as PowerPoint |
| Google Sheets | Not ingested. They appear in Bounced Files as not supported. |
| Google Forms, Drawings, Sites | Not ingested |
| Uploaded files | .pdf, .doc, .docx, .txt, .md, .ppt, .pptx, .msg, and archives (.zip, .rar, .7z) |
Excel, CSV, image, and video files are not ingested. Files in the trash are ignored.
Limits
| Limit | Default |
|---|---|
| Maximum file size | 25 MB. Google also limits exports of Docs and Slides to about 10 MB. |
| Archive contents | Up to 10 files and 50 MB uncompressed |
| Retries per file | A file that fails 3 times is skipped until it's resolved in Bounced Files |
Answers link to the file in Google Drive using its standard view link.
Sync behavior
| Behavior | Details |
|---|---|
| First sync | Full ingestion of the selected drives and folders |
| Later syncs | Incremental. A file is re-ingested when its modified time changes. |
| Deleted or moved files | Removed from the Knowledge Base on the next sync |
| Throttling | Rate-limit and temporary server errors are retried automatically |
Access control
Access comes from the Audience set on each content set. Google Drive sharing permissions are not inherited: every user in the audience can get answers from every file in the content set. Use separate content sets with narrower audiences for restricted content.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| "No Shared Drives found" | The service account isn't a member of any Shared Drive | Add the service account to the Shared Drives (Step 2) |
| Connection fails to authenticate | Wrong email, or an incomplete private key | Paste the full private_key value including the BEGIN and END lines |
| My Drive files don't appear | Only Shared Drives are supported | Move the files to a Shared Drive |
| A folder's files are missing after a sync | Google throttled the requests and the folder was skipped | Click Sync Now again, or schedule the sync outside business hours |
| Google Sheets in Bounced Files | Spreadsheets aren't supported | Export the content to PDF or a Google Doc |
| File bounced for size limit | File is over 25 MB, or a Doc is too large to export | Split the file |
Next Steps
- Manage syncs, logs, and bounced files in Knowledge Integrations
- Set up audience targeting