Overview

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

Supported actions

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

The following actions read Gmail data and are enabled by default:

Action Description
List drafts Lists Gmail drafts in the user's mailbox.
List threads Lists Gmail threads 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.
List labels Lists labels defined in the user's Gmail mailbox.
List filters Lists Gmail filters in the user's mailbox.

The following actions change Gmail data and are turned off by default until an administrator enables them:

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.
Create label Creates a new label in Gmail.
Update label Updates an existing Gmail label.
Delete label Deletes an existing Gmail label.
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.
Delete filter Deletes an existing Gmail filter.

Actions run with the permissions of the user who authorized the connector. A user can only read and change the data that they can already read and change in Gmail.

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.

What's next