概览

借助适用于 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.All
User.ReadBasic.All
列出群组所有者 只读 列出目录中群组的所有者。 GroupMember.Read.All
User.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.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
舍弃结账 写入 取消文档签出并舍弃所有待更改项。 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.All
Files.Read.All
更新 SharePoint 列表 写入 更新 SharePoint 列表的属性(名称、说明)。 Sites.Manage.All
更新列表项 写入 更新现有 SharePoint 列表项中的字段。 Sites.ReadWrite.All
更新 SharePoint 页面 写入 更新 SharePoint 页面的标题或文件名。 Sites.ReadWrite.All

Outlook

操作 类型 说明 所需权限
添加连接 写入 向现有电子邮件或日历活动添加文件附件。 Mail.ReadWrite
Calendars.ReadWrite
创建日历 写入 在用户的邮箱中创建新日历。 Calendars.ReadWrite
Calendars.ReadWrite.Shared
创建联系人 写入 在用户的“通讯录”文件夹中创建新联系人。 Contacts.ReadWrite
创建消息草稿 写入 在用户的邮箱中创建电子邮件草稿。 Mail.ReadWrite
Mail.ReadWrite.Shared
创建日历活动 写入 在用户的日历上创建新活动。 Calendars.ReadWrite
创建回复草稿 写入 创建对现有邮件发件人的回复草稿。 Mail.ReadWrite
Mail.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.ReadWrite
Calendars.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.All
Group.ReadBasic.All
列出渠道 只读 列出 Microsoft Teams 中的频道。 Channel.ReadBasic.All
Group.ReadBasic.All
列出聊天消息 只读 列出 Teams 聊天中的消息。 Chat.Read
列出对话 只读 列出用户参与的 Teams 聊天。 Chat.ReadBasic
列出已加入的团队 只读 列出用户所属的 Microsoft Teams。 Team.ReadBasic.All
列出频道消息回复 只读 读取 Teams 频道话题:其第一篇帖子和其下的回复。 Chat.Read
ChannelMessage.Read.All
Group.ReadBasic.All
列出调度组 只读 列出团队排班表中的排班组。 Schedule.Read.All
列出休假条目 只读 列出团队的排班表中已预订的休假时间。 Schedule.Read.All
列出休假原因 只读 列出团队排班表上可选择的休假原因。 Schedule.Read.All
回复频道消息 写入 回复 Teams 频道中的消息。 ChannelMessage.Send
搜索聊天消息 只读 搜索用户有权访问的 Teams 聊天和频道消息。 Chat.Read
ChannelMessage.Read.All
Group.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 错误。

后续步骤