Overview

The Gmail connector for Gemini Enterprise lets you search and perform actions on your Gmail data using natural language commands.

Note: Gemini Enterprise has released new Google Workspace data connectors for Gmail, Google Drive, Google Chat, and Google Calendar. The new connectors use a Google-managed OAuth app, so you no longer create your own OAuth client or supply a client ID and client secret when you create the data store. For Gmail setup instructions, see Set up a Gmail data store.

Supported actions

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

Action	Description
Send message	Sends a new Gmail message.
Reply	Replies to an existing Gmail message.
Forward	Forwards an existing Gmail message.
Create draft	Creates a new Gmail draft.
Update draft	Updates an existing Gmail draft.
List drafts	Lists Gmail drafts in the user's mailbox.
Search threads	Searches for Gmail threads matching a query.
Get thread	Fetches the full contents of a Gmail thread.
Get message attachment	Fetches metadata for an attachment on a Gmail message.
Create label	Creates a new label in Gmail.
Update label	Updates an existing Gmail label.
Delete label	Deletes an existing Gmail label.
List labels	Lists labels defined in the user's Gmail mailbox.
Label message	Adds one or more existing labels to a specific Gmail message.
Unlabel message	Removes one or more existing labels from a specific Gmail message.
Batch label messages	Adds one or more labels to multiple Gmail messages in a single request.
Batch unlabel messages	Removes one or more labels from multiple Gmail messages in a single request.
Label thread	Adds one or more existing labels to a specific Gmail thread.
Unlabel thread	Removes one or more existing labels from a specific Gmail thread.
Batch label threads	Adds one or more labels to multiple Gmail threads in a single request.
Batch unlabel threads	Removes one or more labels from multiple Gmail threads in a single request.
Create filter	Creates a new Gmail filter.
List filters	Lists Gmail filters in the user's mailbox.
Delete filter	Deletes an existing Gmail filter.

Notes:

• The maximum file size for file uploads and downloads in Gemini Enterprise is 50 MB.

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/gmail.readonly	Search and read Gmail messages, threads, drafts, labels, and attachments.
https://www.googleapis.com/auth/gmail.send	Send and forward Gmail messages and replies.
https://www.googleapis.com/auth/gmail.compose	Create and update Gmail drafts.
https://www.googleapis.com/auth/gmail.modify	Add and remove labels on Gmail messages and threads.
https://www.googleapis.com/auth/gmail.labels	Create, update, and delete Gmail labels.
https://www.googleapis.com/auth/gmail.settings.basic	Create, list, and delete Gmail filters.
https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, openid	Identify the authorizing user.

Limitations

• The Gmail data store is supported only in the global, us, and eu locations.

• When creating a new app or adding a data store to an existing one, it's recommended to associate only one data store with actions belonging to a single connector type.

• If you use security controls, be aware of their limitations related to data in Gmail, 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 Gmail, 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 Gmail.
  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.

What's next

• To create and configure a data store with Gmail, see Set up a Gmail data store.