Skip to main content

​
Overview

The Google Drive connection allows Qontext to ingest documents, presentations, tables, and text files from a connected Google Drive into your Context Vault.
Only files and folders that the connected Google account can access will be ingested into your vault.
Supported file types include:
File typeDescription
Google DocsDocuments
Google SlidesPresentations
Google SheetsSpreadsheets
txtPlain text files
mdMarkdown files
Use a dedicated integration user in your Google Workspace to ensure a stable and uninterrupted connection.
Create a service account such as [email protected] and grant it access to the files and folders you want Qontext to ingest. This prevents sync interruptions if employee accounts change or are deactivated.
The integration user will:
  • Authenticate the connection between Qontext and Google Drive.
  • Access required resources with read and download permissions.

​
Setting Up the Connection

You can connect Google Drive from your Qontext vault, authorize access in Google, then choose what to sync and how often. The steps below walk you through the full flow.
1

Open Data Sources in your vault

In the Qontext app, open the vault where you want to ingest Google Drive data, then go to the Data Sources tab and click Add data source.Data Sources tab in a Qontext vault
2

Select Google Drive as the data source

Choose Google Drive from the list of available data sources. This starts the Google Drive connection flow.Select Google Drive from the list of integrations
3

Choose Google Account & Grant Scopes

Select the Google account that has access to the files you want to ingest, and approve the requested OAuth scopes.Google account selection screenGoogle account access
4

Configure what to sync (filters)

Select the folders and files you want Qontext to ingest into your vault. You can add folders or individual files.Google Drive filtersClick the + next to a folder to add it; open the folder to add subfolders or individual files and select them the same way. Files over 10MB or in an unsupported format cannot be selected. Any such files inside a selected folder are excluded from sync automatically.Google Drive foldersSelected items appear at the top. Use All file types next to a folder to limit which file types are synced from that folder. Click the checkmark next to an item to remove it from the selection.Google Drive file types
5

Set sync frequency

Choose how often Qontext should refresh data from Google Drive (e.g. daily, weekly, monthly). More frequent syncs keep the vault up to date but use more resources.Sync frequency settings
6

Set ingestion instructions (optional)

You can add free-form instructions that tell Qontext how to interpret or prioritize the synced data (e.g. which files to exclude from ingestion). This step is optional.Ingestion instructions field
7

Review and create connection

Review your choices (account, filters, frequency), then confirm to create the connection. Qontext will start the initial sync shortly after.Review summary and create connection

​
Managing Permissions

​
Google Drive OAuth Scopes

When connecting, you will be asked to grant scopes that allow Qontext to read and download files. Example scope descriptions you may see: 
- See and download all your Google Drive files
- See information about your Google Drive files
These are required for Qontext to read data from Google Drive and ingest it into your vault.

​
Google Drive Permissions

  • Use a single person or service account to manage Drive permissions for Qontext. This avoids accidental permission changes that break syncs.
  • If you don’t see a file in Qontext’s Drive tree, verify download permissions using the file’s File info -> Details and ensure Viewers and commenters can see the option to download, print, and copy is enabled.

​
Sync Latency

Qontext preprocesses Drive content before ingesting it into the vault. The initial synchronization time depends on the volume and type of files. Very large workspaces with a large number of files may take up to 12 hours to fully index.
Subsequent syncs process incremental changes and typically complete much faster than the initial sync.

​
FAQ

Qontext supports Google Docs, Google Slides, Google Sheets, txt and md. Files that cannot be downloaded or do not contain extractable text will be skipped.
Yes. You can create multiple Google Drive connections at any time in the Data Sources tab in your Qontext vault.
Manual refresh for Google Drive connections is available via the Data Sources tab.Resync
If you disconnect the Drive connection, no new files will be ingested. Content already ingested from Drive will remain in your vault until you request deletion. For data removal requests, contact [email protected].
Yes. All data is encrypted in transit (TLS) and at rest. Qontext only accesses files you explicitly authorize via Google OAuth scopes.
By default, Qontext only ingests files the connected Google account can access. Additionally, you can add filters to every connection as described in the setup flow.
Yes — reconnect via Data Sources → Add → Google Drive → Select connection. After reconnecting, Qontext will resume syncing from the connected account’s files.