Google Drive Connector

Back to the list of Connectors The Google Drive connector enables the platform to index content from Google Drive into a knowledge base. During setup, you authenticate using a Google OAuth profile, select the folders to index, configure content filters, and enable permission-aware search. The connector supports indexing content from My Drive and Shared Drives, with configurable file type filters, export formats for Google Workspace documents, and synchronization settings.

Prerequisites

Make sure that:

You have access to the Google Drive account or Shared Drive that you want to index.
You’ve created a Google OAuth profile with the required permissions. To create a new profile, go to Settings > Auth Profiles > Add Profile > Integration Profile > Google Docs. Learn More.
The OAuth profile includes read-only Google Drive access.
You have permission to access the folders that you want to synchronize.
The connector requires a Google OAuth profile with the scope as https://www.googleapis.com/auth/drive.readonly.

Create a Google Drive Connector

Navigate to Knowledge Base > Sources.
Click Add Source.
Select Google Drive.

The connector opens in the Connect step of the setup wizard. Provide the following details.

Field	Description
Google OAuth Profile	Specifies the Google OAuth profile used to authenticate the connector with Google Drive. Only authorized OAuth profiles are available for selection. Create a new Google OAuth profile for authenticating with Google Drive, if it doesn’t exist.
Drive Scope	Specifies the Google Drive location to index. You can choose content from your personal Google Drive or a Shared Drive.
Folders	Specifies one or more folders to synchronize. Only content from the selected folders is indexed.
Modified After	Restricts synchronization to files modified after the specified date. Leave blank to index all eligible files.
File Types	Specifies the file types to include during synchronization. Only files matching the selected types are indexed.
Google-native Export Format	Specifies the format used to export Google Workspace files, such as Google Docs, Sheets, and Slides, before extracting their content for indexing.
Index Subfolders	Determines whether subfolders under the selected folders are included during synchronization.
Enforce Google Drive Permissions	Enables permission-aware search by indexing Google Drive access permissions and applying them to search results.
Generate Proposal Preview	Generates a proposal preview to validate the connector configuration, selected scope, permissions, and estimated indexing workload before approval.
Run Dry Run	Validates the connector configuration without initiating synchronization.
Approve & Start	Approves the connector configuration and starts the initial synchronization.
Proposal Preview	Displays the status of the generated proposal preview and summarizes the connector configuration before approval.

Click Generate Proposal Preview to validate the connector configuration, selected scope, permissions, and estimated indexing workload before approval. Perform Dry Run to validate the connector configuration without initiating synchronization. Click Approve & Start to initiate the synchronization.

Google Drive Connector Management

After you activate the connector, you can monitor its health, review synchronization activity, verify security status, and update the connector configuration.

Overview tab

The Overview tab provides a summary of the connector status and recent synchronization activity.

Field	Description
Health	Displays the current connector status, last synchronization details, and document processing statistics.
Configuration	Displays the connector strategy, synchronization mode, and route information.
Objects	Lists the configured crawl objects along with their current state, indexed document count, last synchronization time, and failed documents.
Recent activity	Displays the latest synchronization run, including its status, processed documents, failures, and skipped documents.
View documents	Opens the list of documents indexed by the connector.
Resume Sync	Resumes synchronization if the connector is paused.
Sync Now	Immediately starts a synchronization, regardless of the configured schedule.

Activity tab

The Activity tab displays the synchronization history for the connector.

Field	Description
Sync activity	Lists synchronization runs with details such as status, synchronization type, start time, duration, processed documents, failures, skipped documents, removed documents, validation status, and processed objects.
Permission syncs	Displays the history of permission synchronization operations, including the trigger, mode, duration, synchronized documents, and subjects.
Webhook events	Displays webhook notifications generated by the connector during synchronization.

Security tab

The Security tab provides the current security posture of the connector and highlights any configuration issues.

Settings tab

The Settings tab lets you modify the connector configuration after you’ve activated it. The following additional settings are available in this section.

Field	Description
Reconnect	Re-establishes the connection using the selected Google OAuth profile.
Manage credentials	Opens the OAuth profile associated with the connector for credential management.
Include trashed files	Includes files from the Google Drive Trash during synchronization. By default, trashed files are excluded.
Allow advanced Drive query	Enables the use of a custom Google Drive query in addition to the selected folder scope to further filter indexed content.
Generated Drive Query	Displays the Google Drive query generated from the current connector configuration.
Run a full sync after saving	Performs a complete re-index of the selected content after the configuration changes are saved.
Recrawl permissions after saving	Refreshes document permission metadata after the configuration changes are saved without performing a full content synchronization.
Save Changes	Saves the updated connector configuration.

Changes to the crawl scope, filters, or authentication profile do not automatically trigger a content synchronization or permission recrawl. To apply the changes immediately, manually initiate a Full Sync or a Delta Sync. Otherwise, the changes take effect during the next scheduled synchronization.

Get Started

Build

Test and Evaluate

Deploy

Analytics and Insights

Administration

References

Prerequisites

Create a Google Drive Connector

Google Drive Connector Management

Overview tab

Activity tab

Security tab

Settings tab

​Prerequisites

​Create a Google Drive Connector

​Google Drive Connector Management

​Overview tab

​Activity tab

​Security tab

​Settings tab

Prerequisites

Create a Google Drive Connector

Google Drive Connector Management

Overview tab

Activity tab

Security tab

Settings tab