Overview

Preview

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Public preview: The federated search and actions features are in public preview. This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

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

Note: Gemini Enterprise has released new Google Workspace data connectors for Google Chat, Google Drive, Gmail, 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 Google Chat setup instructions, see Set up a Google Chat data store.

Supported actions

When the Google Chat 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 Google Chat message to a conversation.
Send message (Markdown)	Sends a Google Chat message to a conversation with Markdown formatting.
List messages	Retrieves messages from a specified Google Chat conversation (space, direct message, or group direct message).
List messages (Markdown)	Retrieves messages from a specified Google Chat conversation in Markdown format.
Search messages	Searches for Google Chat messages using keywords and filters. Works across all spaces the user has access to, or can be scoped to a specific conversation.
Search conversations	Searches for Google Chat conversations by display name.
Create conversation	Creates a Google Chat conversation (named space, direct message, or group direct message).
Add reaction	Adds a reaction to a Google Chat message.
Remove reaction	Removes a reaction from a Google Chat message.
Add membership	Adds a member to a Google Chat conversation.
Remove membership	Removes a user membership from a Google Chat conversation.
Update membership	Updates a user membership in a Google Chat conversation.
List memberships	Lists memberships in a Google Chat conversation.

Required permissions

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/chat.spaces.readonly	List and search Google Chat conversations.
https://www.googleapis.com/auth/chat.messages.readonly	Read and search Google Chat messages.
https://www.googleapis.com/auth/chat.memberships.readonly	List memberships in a Google Chat conversation.
https://www.googleapis.com/auth/chat.users.readstate.readonly	Read the user's read state for Google Chat messages.
https://www.googleapis.com/auth/chat.messages.create	Send Google Chat messages.
https://www.googleapis.com/auth/chat.spaces.create	Create Google Chat conversations.
https://www.googleapis.com/auth/chat.memberships	Add, remove, and update members in a Google Chat conversation.
https://www.googleapis.com/auth/chat.messages.reactions.create	Add a reaction to a Google Chat message.
https://www.googleapis.com/auth/chat.messages.reactions	Remove a reaction from a Google Chat message.

Limitations

• The Google Chat 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 Google Chat, 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 Chat, 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 Chat.
  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 Google Chat, see Set up a Google Chat data store.