> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Google Drive Connector
[Back to the list of Connectors](/agent-platform/knowledge#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](/agent-platform/administration/integrations-settings#auth-profiles).
* 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
1. Navigate to **Knowledge Base** > **Sources**.
2. Click **Add Source**.
3. 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.