使用 Microsoft Graph 连接器 API

Microsoft Graph 连接器将外部数据引入到 Microsoft Graph 中并增强 Microsoft 365 智能体验。 你可能希望构建自定义连接器，以与未作为 Microsoft 构建的连接器的服务集成。 若要构建自定义连接器，请使用 Microsoft Graph 连接器 REST API。 通过使用 API 生成的连接引入的项使用项配额。 若要详细了解如何确定拥有多少项配额并购买其他配额，请参阅 许可要求和定价。

可以使用 Microsoft Graph 连接器 API 来：

1. 创建和管理外部数据连接。
2. 定义和注册外部数据类型的架构。
3. 将外部数据项提取到 Microsoft Graph 中。
4. 同步外部组。

创建和管理外部数据连接

externalConnection 资源（外部连接 API）是外部数据的逻辑容器，可将其作为单一单元进行管理。

要了解详细信息，请参阅 创建、更新和删除 Microsoft Graph 中的连接。

定义和注册外部数据类型的架构

连接架构 (架构 API) 确定如何在各种 Microsoft 365 体验中使用内容。 架构是计划与其特性、标签和别名一起添加到连接中的所有属性的简单列表。 必须先注册架构，然后才能将项目提取到 Microsoft Graph 中。

要了解详细信息，请参阅 注册并更新 Microsoft Graph 连接的架构。

将外部数据项提取到 Microsoft Graph 中

应用程序添加到 Microsoft 搜索服务的项目由 Microsoft Graph 中的 externalItem 资源（外部项目 API）表示。

要了解详细信息，请参阅 通过 Microsoft Graph 连接器创建、更新和删除应用程序添加的项目。

同步外部组

可以通过 ACL 向外部服务中的项授予或拒绝对不同类型的非Microsoft Entra组的访问权限。 例如，Salesforce 项可能具有权限集和配置文件，而 ServiceNow 项可能具有本地组。 将这些项目提取到 Microsoft Graph 中时，需要遵守这些 ACL。

可以使用外部组 API 来设置对提取到 Microsoft Graph 中的外部项的权限。 externalGroup 表示非 Microsoft Entra 组或类似组的构造（例如业务部门、团队等），并确定对外部数据源中内容的权限。

要了解详细信息，请参阅 使用外部组管理对 Microsoft Graph 连接器数据源的权限。

后续步骤

生成自定义连接器