借助适用于 Gemini Enterprise 的 Microsoft 365 连接器,您可以通过单个连接器搜索和处理 Microsoft 365 中的数据,包括 SharePoint 网站、OneDrive 文件、Outlook 邮件、Outlook 日历、联系人和 Microsoft Teams。该连接器通过 Microsoft Graph API 访问所有这些平台。
由于一个连接器涵盖所有 Microsoft 365 平台,因此您无需为 SharePoint、OneDrive、Outlook 和 Teams 创建单独的数据存储区。
该连接器支持两种 OAuth 2.0 身份验证方法:
- Google管理的 OAuth(默认):连接器使用 Google 管理的 Microsoft Entra 应用。您无需注册自己的应用,也无需提供客户端 ID 和客户端密钥。
- 自带应用:注册您自己的 Microsoft Entra 应用,并在设置数据存储区时提供其租户 ID、客户端 ID 和客户端密钥。
如需了解详情,请参阅 Microsoft 365 配置。
支持的操作
启用 Microsoft 365 连接器后,最终用户可以在 Gemini Enterprise 中使用自然语言命令来执行以下操作。 这些操作按其作用的 Microsoft 365 产品进行分组,这与您在Google Cloud 控制台中选择操作时的分组方式一致。对于每项操作,表格都会显示该操作是仅读取数据还是会进行更改,以及该操作所需的委托 Microsoft Graph 权限。如需了解如何请求和授予权限,请参阅权限。
用户和群组
| 操作 | 类型 | 说明 | 所需权限 |
|---|---|---|---|
| 添加群组成员 | 写入 | 将用户添加为群组成员。 | GroupMember.ReadWrite.All |
| 添加群组所有者 | 写入 | 将用户添加为群组的所有者。 | Group.ReadWrite.All |
| 创建群组 | 写入 | 创建新的 Microsoft 365 群组。 | Group.ReadWrite.All |
| 获取我的个人资料 | 只读 | 检索已登录用户的个人资料,包括其 Microsoft 账号所关联的邮箱。 | User.Read |
| 获取用户个人资料 | 只读 | 检索目录中用户的个人资料。 | User.ReadBasic.All |
| 获取用户工作资料 | 只读 | 检索用户的职位、部门、办公室、手机号码、主管和直接下属。 | User.Read.All |
| 列出群组成员 | 只读 | 列出目录中群组的直接成员。 | Group.ReadBasic.AllUser.ReadBasic.All |
| 列出群组所有者 | 只读 | 列出目录中群组的所有者。 | GroupMember.Read.AllUser.ReadBasic.All |
| 列出组 | 只读 | 按名称在目录中查找群组,并返回每个群组的 ID。 | Group.ReadBasic.All |
| 在通讯录中查找联系人 | 只读 | 按姓名或邮箱在组织目录中查找人员。 | User.ReadBasic.All |
| 更新群组 | 写入 | 更新群组的名称、说明或公开范围。 | Group.ReadWrite.All |
SharePoint 和 OneDrive
| 操作 | 类型 | 说明 | 所需权限 |
|---|---|---|---|
| 获取 Excel 范围 | 只读 | 读取工作表中某个单元格块(包括表格外的单元格)内的单元格值。 | Files.Read.All |
| 获取 Excel 表格行 | 只读 | 读取 Excel 工作簿中表格的一行,并包含表格的列标题。 | Files.Read.All |
| 获取 Excel 表格行 | 只读 | 读取 Excel 工作簿中表格的数据行,以及表格的列标题。 | Files.Read.All |
| 列出 Excel 表 | 只读 | 列出 Excel 工作簿中已设置格式的表格以及每个表格所在的工作表。 | Files.Read.All |
| 获取 Excel 工作簿属性 | 只读 | 读取 Excel 工作簿的文件属性:名称、大小、网址和上次更改者。 | Files.Read.All |
| 获取 Excel 工作表 | 只读 | 读取 Excel 工作簿的一个工作表及其数据范围。 | Files.Read.All |
| 列出 Excel 工作表 | 只读 | 按标签页顺序列出 Excel 工作簿中的工作表。 | Files.Read.All |
| 列出 Excel 工作簿 | 只读 | 在用户可以访问的 OneDrive 和 SharePoint 网站中查找 Excel 工作簿。 | Sites.Read.AllFiles.Read.All |
| 在文档中签入 | 写入 | 签入文档,释放其编辑锁定,并使其可供其他人使用。 | Files.ReadWrite.All |
| 查看文档 | 写入 | 签出文档,将其锁定以进行独占编辑。 | Files.ReadWrite.All |
| 复制文件 | 写入 | 将文件复制到新位置。 | Files.ReadWrite.All |
| 复制文件夹 | 写入 | 将文件夹复制到新位置。 | Files.ReadWrite.All |
| 创建文件 | 写入 | 在文件夹中创建具有给定名称的新文件。绝不会覆盖现有文件;如需覆盖,请使用替换文件内容。 | Files.ReadWrite.All |
| 创建文件夹 | 写入 | 在现有文件夹中创建新文件夹。 | Files.ReadWrite.All |
| 创建分享链接 | 写入 | 创建指向文件或文件夹的可共享链接。 | Files.ReadWrite.All |
| 舍弃结账 | 写入 | 取消文档签出并舍弃所有待更改项。 | Files.ReadWrite.All |
| 通过网址获取文件或文件夹 | 只读 | 查找 SharePoint 或 OneDrive 链接指向的文件或文件夹,以便读取或执行操作。 | Files.Read.All |
| 下载文件内容 | 只读 | 下载存储在云端硬盘中的文件的原始内容。 | Files.Read.All |
| 获取我的 OneDrive | 只读 | 获取已登录用户自己的 OneDrive,以便将文件保存到其顶层或在顶层列出文件,并报告其存储空间配额。 | Files.Read.All |
| 列出文件夹内容 | 只读 | 列出云端硬盘中某个文件夹内的文件和文件夹。 | Files.Read.All |
| 列出文件权限 | 只读 | 列出对文件或文件夹设置的共享权限。 | Files.Read.All |
| 移动文件 | 写入 | 将文件移至其他文件夹。 | Files.ReadWrite.All |
| 移动文件夹 | 写入 | 将文件夹移至其他父级文件夹。 | Files.ReadWrite.All |
| 重命名文件 | 写入 | 重命名文件。 | Files.ReadWrite.All |
| 重命名文件夹 | 写入 | 重命名文件夹。 | Files.ReadWrite.All |
| 替换文件内容 | 写入 | 替换已存在文件的全部内容。如需创建新文件,请使用创建文件。 | Files.ReadWrite.All |
| 发送共享邀请 | 写入 | 发送文件或文件夹的共享邀请。 | Files.ReadWrite.All |
| 更新文件或文件夹属性 | 写入 | 更新文件或文件夹的属性(名称、说明、父文件夹)。 | Files.ReadWrite.All |
| 创建 SharePoint 列表 | 写入 | 在 SharePoint 网站上创建新列表。 | Sites.Manage.All |
| 创建列表项 | 写入 | 在 SharePoint 列表中创建新项。 | Sites.ReadWrite.All |
| 创建 SharePoint 页面 | 写入 | 在 SharePoint 网站上创建新页面。 | Sites.ReadWrite.All |
| 获取列表项 | 只读 | 检索 SharePoint 列表的单行及其列值。 | Sites.Read.All |
| 获取 SharePoint 页面内容 | 只读 | 检索 SharePoint 页面的 HTML 正文。 | Sites.Read.All |
| 列出列表项 | 只读 | 读取 SharePoint 列表的行,以及每行的列值。 | Sites.Read.All |
| 列出 SharePoint 列表 | 只读 | 列出网站上的 SharePoint 列表,包括每个列表的 ID 和模板。 | Sites.Read.All |
| 列出 SharePoint 页面 | 只读 | 列出 SharePoint 网站上的页面,以及每个页面的标题、网址和发布状态。 | Sites.Read.All |
| 搜索 SharePoint 和 OneDrive | 只读 | 搜索用户可以访问的 SharePoint 网站、页面、列表项和 OneDrive 文件。 | Sites.Read.AllFiles.Read.All |
| 更新 SharePoint 列表 | 写入 | 更新 SharePoint 列表的属性(名称、说明)。 | Sites.Manage.All |
| 更新列表项 | 写入 | 更新现有 SharePoint 列表项中的字段。 | Sites.ReadWrite.All |
| 更新 SharePoint 页面 | 写入 | 更新 SharePoint 页面的标题或文件名。 | Sites.ReadWrite.All |
Outlook
| 操作 | 类型 | 说明 | 所需权限 |
|---|---|---|---|
| 添加连接 | 写入 | 向现有电子邮件或日历活动添加文件附件。 | Mail.ReadWriteCalendars.ReadWrite |
| 创建日历 | 写入 | 在用户的邮箱中创建新日历。 | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| 创建联系人 | 写入 | 在用户的“通讯录”文件夹中创建新联系人。 | Contacts.ReadWrite |
| 创建消息草稿 | 写入 | 在用户的邮箱中创建电子邮件草稿。 | Mail.ReadWriteMail.ReadWrite.Shared |
| 创建日历活动 | 写入 | 在用户的日历上创建新活动。 | Calendars.ReadWrite |
| 创建回复草稿 | 写入 | 创建对现有邮件发件人的回复草稿。 | Mail.ReadWriteMail.ReadWrite.Shared |
| 查找会议时间 | 只读 | 根据参加者的空闲时间建议会议时间。 | Calendars.Read.Shared |
| 转发信息 | 写入 | 将现有邮件转发给指定收件人。 | Mail.Send |
| 获取邮件附件 | 只读 | 从用户邮箱中的邮件中检索一个文件附件的字节。 | Mail.Read |
| 获取自动回复 | 只读 | 检索用户的 Outlook 自动回复(不在办公室)设置。 | MailboxSettings.Read |
| 获取日历活动 | 只读 | 从用户的 Outlook 日历中检索一个活动,包括参加者回复和附件 ID。 | Calendars.Read |
| 获取日历活动附件 | 只读 | 从用户日历中的活动中检索一个文件附件的字节。 | Calendars.Read |
| 获取电子邮件 | 只读 | 从用户的邮箱中检索单封邮件。 | Mail.Read |
| 获取时间表空闲状态 | 只读 | 检索用户、会议室或设备在某个时间范围内的有空/忙碌状态。 | Calendars.Read |
| 列出日历活动 | 只读 | 列出用户日历中在某个时间范围内的活动。 | Calendars.Read |
| 列出日历 | 只读 | 列出用户邮箱中的日历。 | Calendars.Read |
| 列出 Outlook 类别 | 只读 | 列出用户 Outlook 类别列表中的类别(标签)。 | MailboxSettings.Read |
| 列出联系人 | 只读 | 列出或搜索用户 Outlook 通讯簿中的联系人。 | Contacts.Read |
| 列出收件箱规则 | 只读 | 列出用户的 Outlook 收件箱规则。 | MailboxSettings.Read |
| 列出邮件文件夹 | 只读 | 列出用户邮箱中的邮件文件夹。 | Mail.ReadBasic |
| 列出文件夹中的邮件 | 只读 | 列出用户某个邮件文件夹(例如收件箱或已发送邮件)中的邮件。 | Mail.Read |
| 列出或搜索共享邮箱 | 只读 | 列出或搜索用户有权访问的共享邮箱或委托邮箱中的邮件。 | Mail.Read.Shared |
| 移动消息 | 写入 | 将电子邮件移至其他邮件文件夹。 | Mail.ReadWrite |
| 回复所有邮件 | 写入 | 回复现有电子邮件,发送给发件人和所有其他收件人,并将回复保留在原始会话中。 | Mail.Send |
| 回复消息 | 写入 | 回复现有电子邮件,回复其发件人,并将回复保留在原始会话中。 | Mail.Send |
| 回复活动邀请 | 写入 | 回复会议邀请(接受、暂时接受或拒绝)。 | Calendars.ReadWrite |
| 搜索电子邮件 | 只读 | 按关键字搜索用户的 Outlook 邮件。 | Mail.Read |
| 搜索文件夹中的电子邮件 | 只读 | 按关键字、发件人或主题,在用户自己的某个邮件文件夹(包括子文件夹,例如“收件箱/账单”)中搜索邮件。 | Mail.Read |
| 搜索日历活动 | 只读 | 按关键字搜索用户的 Outlook 日历活动。 | Calendars.Read |
| 发送消息草稿 | 写入 | 发送现有草稿邮件。 | Mail.Send |
| 发送邮件 | 写入 | 撰写并发送新电子邮件。 | Mail.Send |
| 更新日历 | 写入 | 更新现有日历的属性(名称、颜色或默认状态)。 | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| 更新联系人 | 写入 | 更新现有联系人的属性。 | Contacts.ReadWrite |
| 更新活动 | 写入 | 更新现有日历活动的属性。 | Calendars.ReadWrite |
| 更新信息 | 写入 | 更新现有电子邮件的属性(例如,标记为已读、更改标记或重要性)。 | Mail.ReadWrite |
| 列出任务列表 | 只读 | 列出用户的 Microsoft To Do(Outlook 任务)任务列表。 | Tasks.Read |
| 列出任务 | 只读 | 列出用户的某个 Microsoft To Do(Outlook 任务)列表中的任务。 | Tasks.Read |
团队
| 操作 | 类型 | 说明 | 所需权限 |
|---|---|---|---|
| 向频道添加成员 | 写入 | 将用户添加到私密或共享 Teams 频道。 | ChannelMember.ReadWrite.All |
| 创建渠道 | 写入 | 在 Teams 团队中创建新频道。 | Channel.Create |
| 创建对话 | 写入 | 创建新的 Teams 聊天(一对一、群组或会议聊天)。 | Chat.Create |
| 创建会议 | 写入 | 创建新的 Teams 在线会议。 | OnlineMeetings.ReadWrite |
| 创建排班组 | 写入 | 在 Teams 排班中创建排班群组。 | Schedule.ReadWrite.All |
| 创建休假条目 | 写入 | 在 Teams 排班中为用户创建休假条目。 | Schedule.ReadWrite.All |
| 创建休假原因 | 写入 | 为 Teams 时间表创建新的休假原因(例如,休假、病假)。 | Schedule.ReadWrite.All |
| 获取时间表 | 只读 | 读取团队的排班时间表设置和预配状态。 | Schedule.Read.All |
| 列出频道成员 | 只读 | 列出 Teams 频道中的成员及其角色。 | ChannelMember.Read.All |
| 列出频道消息 | 只读 | 列出 Teams 频道中的消息。 | ChannelMessage.Read.AllGroup.ReadBasic.All |
| 列出渠道 | 只读 | 列出 Microsoft Teams 中的频道。 | Channel.ReadBasic.AllGroup.ReadBasic.All |
| 列出聊天消息 | 只读 | 列出 Teams 聊天中的消息。 | Chat.Read |
| 列出对话 | 只读 | 列出用户参与的 Teams 聊天。 | Chat.ReadBasic |
| 列出已加入的团队 | 只读 | 列出用户所属的 Microsoft Teams。 | Team.ReadBasic.All |
| 列出频道消息回复 | 只读 | 读取 Teams 频道话题:其第一篇帖子和其下的回复。 | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| 列出调度组 | 只读 | 列出团队排班表中的排班组。 | Schedule.Read.All |
| 列出休假条目 | 只读 | 列出团队的排班表中已预订的休假时间。 | Schedule.Read.All |
| 列出休假原因 | 只读 | 列出团队排班表上可选择的休假原因。 | Schedule.Read.All |
| 回复频道消息 | 写入 | 回复 Teams 频道中的消息。 | ChannelMessage.Send |
| 搜索聊天消息 | 只读 | 搜索用户有权访问的 Teams 聊天和频道消息。 | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| 发送频道消息 | 写入 | 在 Teams 频道中发布消息。 | ChannelMessage.Send |
| 发送聊天消息 | 写入 | 在 Teams 聊天中发送消息。 | ChatMessage.Send |
| 更新渠道 | 写入 | 更新 Teams 频道的名称或说明。 | ChannelSettings.ReadWrite.All |
| 更新频道消息 | 写入 | 修改之前发布的频道消息。 | ChannelMessage.ReadWrite |
| 更新对话 | 写入 | 更新 Teams 群聊的主题。 | Chat.ReadWrite |
| 更新聊天消息 | 写入 | 修改之前发送的聊天消息。 | Chat.ReadWrite |
| 更新排班组 | 写入 | 更新排班组的名称、有效状态或成员。 | Schedule.ReadWrite.All |
| 更新团队 | 写入 | 更新 Teams 团队的名称、说明或公开范围。 | TeamSettings.ReadWrite.All |
| 更新休假条目 | 写入 | 更新现有休假条目。 | Schedule.ReadWrite.All |
权限
上表中的所需权限列列出了每项操作所需的委托 Microsoft Graph 权限。Gemini Enterprise 仅会请求执行您启用的操作所需的权限,以及每个连接都会请求的以下权限:
User.Read:读取已登录用户的个人资料,该个人资料可标识连接器所代表的账号。offline_access:让连接器刷新其访问令牌,而无需让用户再次登录。
所有权限均已委托:连接器充当已登录用户,只能访问该用户已能访问的数据。
借助 Google管理的 OAuth,用户在授权连接器时会同意这些权限;某些权限需要 Microsoft Entra 管理员为组织同意。对于您自己的应用,您可以在应用注册时授予这些权限。如需了解详情,请参阅配置 Microsoft API 权限。
限制
本部分概述了可能会影响您使用 Microsoft 365 数据存储区的已知问题和限制。
- 创建新应用或向现有应用添加数据存储区时,建议仅将一个数据存储区与属于单一连接器类型的操作相关联。
- 不支持对现有 Microsoft 365 数据存储区强制执行 VPC Service Controls 边界。 如需强制执行 VPC Service Controls,您必须删除并重新创建该数据存储区。如需详细了解 VPC Service Controls 以及如何在启用 VPC Service Controls 后使用操作,请参阅使用 VPC Service Controls 保护应用的安全。
- Microsoft 365 数据存储区仅在
global、us和eu位置受支持。
Microsoft 365 数据存储区与单个 Microsoft 365 租户一一对应。它不能跨多租户组织 (MTO) 内的多个隔离租户。您必须为每个不同的租户创建专用数据存储区。
Google管理的 OAuth 仅支持商业 Microsoft 云(包括 GCC)中的租户,不支持静态 IP 出站流量。对于 GCC High 或 DoD 租户,或者要使用静态 IP 出站流量,请使用您自己的 Microsoft Entra 应用。
邮箱必须完全迁移到 Exchange Online。无法通过 Microsoft Graph API 访问混合 Exchange 环境中本地托管的邮箱,并且针对这些邮箱的查询可能会返回
MailboxNotEnabledForRESTAPI错误。
后续步骤
如需创建和配置 Microsoft 365 数据存储区,请参阅设置 Microsoft 365 数据存储区。
如需配置连接器用于进行身份验证的 Microsoft Entra 应用,请参阅 Microsoft 365 配置。
如需查看和管理已启用的操作,请参阅管理操作。