Note: This documentation set is for the Standard, Plus, Pay-as-you-go, and Frontline editions of Gemini Enterprise. For the Business edition documentation, see the Gemini Enterprise - Business edition Help Center.

Overview

The Google Drive data store for Gemini Enterprise lets you search and perform actions on your Google Drive data, including files and folders.

Supported actions

When the Google Drive data store is enabled, end users can use natural language commands in Gemini Enterprise to perform the following actions.

Action	Description
Copy file	Copies a file in Google Drive.
Create file	Creates a new file in Google Drive.
Download file content	Downloads the content of a Google Drive file.
Get file metadata	Fetches metadata for a Google Drive file.
Get file permissions	Lists the permissions on a Google Drive file.
List recent files	Lists recent files in Google Drive.
Read file content	Reads the contents of a Google Drive file.
Search files	Searches for Google Drive files matching a query.
Share file	Shares a Google Drive file with one or more users.
Trash file	Moves a Google Drive file to the trash.
Update file	Updates an existing Google Drive file.

Required scopes

The Google-managed OAuth app requests the following OAuth scopes. Users grant these scopes when they authorize the connector:

Scope	Purpose
`https://www.googleapis.com/auth/drive.readonly`	Search and retrieve Google Drive content. Lets the data store list files and folders, view metadata, list permissions, and read file content.
`https://www.googleapis.com/auth/drive.metadata.readonly`	Read Google Drive file metadata.
`https://www.googleapis.com/auth/drive.file`	Create and update files that the user opens or creates with the connector.
`https://www.googleapis.com/auth/drive.appdata`	Store application-specific data in Google Drive.
`https://www.googleapis.com/auth/drive`	Perform write actions on Google Drive files (for example, copy, share, trash, and update).

Limitations

The Google Drive data store is supported only in the global, us, and eu locations.

If you use security controls, be aware of their limitations related to data in Google Drive, as discussed in the following table:

Security control	Note the following
Data Residency (DRZ)	Gemini Enterprise only guarantees data residency in Google Cloud. For information about data residency and Google Drive, see Google Workspace compliance guidance and documentation, including Data regions for Google Workspace. Also review examples like Choose the region where data is stored and Digital sovereignty.
Customer-managed encryption keys (CMEK)	Your keys only encrypt data within Google Cloud. Cloud Key Management Service controls don't apply to data stored in Google Drive.
Access Transparency	Access Transparency logs actions taken by Google personnel on the Google Cloud project. You'll also need to review the Access Transparency logs created by Google Workspace. For more information, see Access Transparency log events in the Google Workspace Admin Help documentation.

Common search issues

If your search doesn't return the file you're looking for, it might be due to one of the following search index limitations of Google Drive:

Google Drive only extracts 1 MB of text and formatting data from your file to make it searchable. Keywords exceeding the 1 MB index limit aren't searchable.
For most file types, file size cannot exceed 10 MB. The following are exceptions:
- XLSX files (.xlsx) cannot exceed 20 MB.
- PDF files (.pdf) cannot exceed 30 MB.
- Text files (.txt) cannot exceed 100 MB.
Note: Files exceeding the size limit are not searchable and won't appear in your search results.
Optical character recognition in PDF files is limited to 80 pages. Google Drive doesn't index any PDF that is larger than 50 MB or 80 pages.

What's next

To create and configure a data store with Google Drive, see Set up a Google Drive data store.