The Microsoft Teams data store for Gemini Enterprise lets you search and perform actions on your channels, chats, and schedules.

> [!NOTE]
> **Note:** When using federated search or federated connectors, your query string is sent to all enabled third-party search backends. The query string sent to a third-party system might contain parts of the data in your search request and conversation history. The third-party system can link the query with your identity. Once data is in the third-party system, it is subject to that system's Terms of Service and privacy policies, not Google Cloud's Terms of Service.

## Supported Microsoft Teams versions

The Microsoft Teams data store supports Microsoft Teams version 2.1 and later.

## Supported actions

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

| Action | Description |
|---|---|
| Send channel message | Sends a message to a specified channel. |
| Send chat message | Sends a message in a chat. |
| Update channel message | Updates an existing message in a specified channel. |
| Update chat message | Updates an existing message in a chat. |
| Create channel | Creates a new channel in a specified team. |
| Update channel | Updates an existing channel's display name, description, or type in a specified team. |
| Create chat | Creates a new one-to-one or group chat. |
| Update chat | Updates metadata of an existing chat, such as the topic. |
| Add member to channel | Adds a member to an existing channel. |
| Create schedule | Creates a new schedule for a team in the Shifts application. |
| Create time off entry | Creates a time-off entry for a team member. |
| Update time off entry | Updates an existing time-off entry for a team member. |

> [!NOTE]
> **Note:** Additional read-only actions are also available.

## Required permissions

To enable Gemini Enterprise to perform federated search and actions using Microsoft Teams, you need the following graph permissions.

> [!NOTE]
> **Note:** An administrator must [grant consent](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/ms-teams/ms-teams-config.md.txt#grant-admin-consent) for all the delegated permissions listed below. Once consent is granted, the "Status" column will display "Granted" with a green tick mark (✓).

| Connection mode | Permission | Permission type | Purpose |
|---|---|---|---|
| Federated search | `Channel.ReadBasic.All` | Delegated | Allows the app to read the names and descriptions of channels. |
| Federated search | `ChannelMember.Read.All` | Delegated | Allows the app to read the members of channels. |
| Federated search | `ChannelMessage.Read.All` | Delegated | Allows the app to read user channel messages. |
| Federated search | `Chat.Read` | Delegated | Allows the app to read all chats. |
| Federated search | `Chat.ReadBasic` | Delegated | Allows the app to read basic properties of chats. |
| Federated search | `ChatMessage.Read` | Delegated | Allows the app to read all one-to-one and group chats messages. |
| Federated search | `Group.Read.All` | Delegated | Allows the app to read the Microsoft Purview sensitivity labels assigned to a team's parent Microsoft 365 group, which are used to apply Sensitive Data Protection content policies to Microsoft Teams content. |
| Federated search | `Schedule.Read.All` | Delegated | Allows the app to read schedules, schedule groups, and shifts for teams. |
| Federated search | `Team.ReadBasic.All` | Delegated | Allows the app to read the names and description of teams. |
| Federated search | `TeamMember.Read.All` | Delegated | Allows the app to read the members of teams. |
| Federated search | `User.Read.All` | Delegated | Allows the app to read all users' full profiles. |
| Federated search and actions | `Channel.Create` | Delegated | Allows the app to create channels in Microsoft Teams. Required for the create channel action. |
| Federated search and actions | `Channel.ReadBasic.All` | Delegated | Allows the app to read the names and descriptions of channels. |
| Federated search and actions | `ChannelMember.Read.All` | Delegated | Allows the app to read the members of channels. |
| Federated search and actions | `ChannelMember.ReadWrite.All` | Delegated | Allows the app to add and remove members from channels. Required for the add member to channel action. |
| Federated search and actions | `ChannelMessage.Read.All` | Delegated | Allows the app to read user channel messages. |
| Federated search and actions | `ChannelMessage.ReadWrite` | Delegated | Allows the app to update channel messages. Required for the update channel message action. |
| Federated search and actions | `ChannelMessage.Send` | Delegated | Allows the app to send messages in any channel. |
| Federated search and actions | `ChannelSettings.ReadWrite.All` | Delegated | Allows the app to read and update the settings of channels. Required for the update channel action. |
| Federated search and actions | `Chat.Create` | Delegated | Allows the app to create new chats. Required for the create chat action. |
| Federated search and actions | `Chat.Read` | Delegated | Allows the app to read all chats. |
| Federated search and actions | `Chat.ReadBasic` | Delegated | Allows the app to read basic properties of chats. |
| Federated search and actions | `Chat.ReadWrite` | Delegated | Allows the app to read and write one-to-one and group chat threads, including chat messages. Required for the update chat and update chat message actions. |
| Federated search and actions | `ChatMessage.Read` | Delegated | Allows the app to read all one-to-one and group chat messages. |
| Federated search and actions | `ChatMessage.Send` | Delegated | Allows the app to send chat messages. |
| Federated search and actions | `Group.Read.All` | Delegated | Allows the app to read the Microsoft Purview sensitivity labels assigned to a team's parent Microsoft 365 group, which are used to apply Sensitive Data Protection content policies to Microsoft Teams content. |
| Federated search and actions | `Schedule.Read.All` | Delegated | Allows the app to read schedules, schedule groups, and shifts for teams. |
| Federated search and actions | `Schedule.ReadWrite.All` | Delegated | Allows the app to create and update schedules, shifts, and time-off entries for teams. Required for the create schedule, create time off entry, and update time off entry actions. |
| Federated search and actions | `Team.ReadBasic.All` | Delegated | Allows the app to read the names and description of teams. |
| Federated search and actions | `TeamMember.Read.All` | Delegated | Allows the app to read the members of teams. |
| Federated search and actions | `User.Read.All` | Delegated | Allows the app to read all users' full profiles. |

For information about how to configure these permissions, see [Configure the Microsoft Graph permissions](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/ms-teams/ms-teams-config.md.txt#microsoft-graph-minimum-permissions). For a detailed reference on graph permissions, see the Microsoft documentation on [Minimum graph permissions reference](https://learn.microsoft.com/en-us/graph/permissions-reference).

## Limitations

The Microsoft Teams data store for Gemini Enterprise has the following limitations:


- 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.

<!-- -->

- Enforcing a VPC Service Controls perimeter on existing Microsoft Teams data stores is not supported. To enforce VPC Service Controls, you must delete and recreate the data stores. For more information on VPC Service Controls and how to use actions after enabling VPC Service Controls, see [Secure your app with VPC Service Controls](https://docs.cloud.google.com/gemini/enterprise/docs/use-vpc-service-controls.md.txt).

<!-- -->

- The Microsoft Teams data store is supported only in the `global`, `us`, and `eu` locations.

<br />

## What's next

- To create and configure a data store with Microsoft Teams, see [Set up a Microsoft Teams data store](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/ms-teams/set-up-data-store.md.txt).