Integrations
Google Drive
Connect Google Drive once at the tenant level. Synced files land in your library automatically and can be attached to any project instantly.
Overview
Connect Google Drive to sync files from shared drives and folders into your Alloovium tenant library. The integration supports Google Docs, Sheets, Slides (converted to DOCX/XLSX/PPTX), and standard files (PDF, Word, etc.). Connection is tenant-level — files are not tied to a specific project at sync time.
Google Workspace files (Docs, Sheets, Slides) are automatically exported to plain text or PDF for ingestion. Native files (PDFs, Word documents, images) are processed directly. Folder-level permissions from Google Drive are respected — team members only see documents their account has access to.
Read-only access
Alloovium requests read-only access to Google Drive. We never create, modify, or delete any files in your Drive. Read our data handling commitments →What data we access
We read files and folder structure from the specific folders you select during setup. This includes PDFs, Word documents, images, and Google Workspace files converted to text. We do not access files outside your selected folders, your Google account settings, contacts, or any other Google services.
Setup
Connecting Google Drive takes about two minutes. The connection is tenant-level— it does not bind to any single project. Synced files land in your tenant's file library, where any project can pull them in instantly.
- 1
Connect Google Drive
Go to Integrations → Google Drive. Click "Connect" and sign in with a Google account that has access to the drives you want to sync.
- 2
Select folders to sync
Choose which folders or shared drives to include. Files from these locations will be ingested into your tenant library — extracted, chunked, and embedded — once. Attaching them to projects is a separate step.
- 3
Configure sync frequency
Set how often Alloovium should check for new or updated files (every 15 minutes, hourly, or daily). Updates flow through to every project the file is attached to.
- 4
Run the initial sync
Alloovium begins ingesting files from your selected folders. Progress is shown in the integrations panel. Large folders may take several minutes.
Screenshot: Google Drive folder picker showing selected folders in Alloovium
Shared drives
If your team stores project documents in a Google Workspace Shared Drive, connect using an account that has at least Viewer access to that shared drive. Personal My Drive and Shared Drives are both supported.Attaching files to projects
Once a file is in your tenant library, attaching it to a project is instant — no re-upload, no re-extraction. You have two options:
- Attach from inside a project. Open any project, click Add from library, search or filter by source (Google Drive), multi-select, and attach. Useful when you decide later which files belong where.
- Pre-attach during sync (optional). When you start a sync, you can optionally pick one or more projects to auto-attach files to as they finish ingesting. Skippable — leave it empty to just sync into the library.
The same Drive file can be attached to as many projects as you like. There is one copy of the file and one set of embeddings; project attachments are pointers. If the file is updated in Drive, every project sees the new version automatically.
Permissions
Alloovium requests the following Google OAuth scopes:
- drive.readonly — read files and folders from drives you own or have access to
- drive.metadata.readonly — read file metadata (names, sizes, dates)
We do not request drive.file, drive.appdata, or any write scope.
Troubleshooting
Google consent screen warns about unverified app
During initial setup, Google may display a warning about an unverified app. Click Advanced, then "Go to Alloovium (unsafe)" to proceed. This warning appears until the app completes Google's verification process. The integration itself is fully secure.
Folders not showing in Alloovium
Only folders your connected Google account has at least Viewer access to will appear. If a shared drive is missing, ensure your account has been added as a member of that shared drive — a subscription link is not sufficient.
Google Docs not appearing as expected
Google Docs, Sheets, and Slides are exported to plain text or PDF at import time. If a document shows as blank, it may have been created with drawing-only content that cannot be extracted as text. Contact support if you need custom export handling.