Trabajar con la API de conectores de Microsoft Graph

Los conectores de Microsoft Graph incorporan datos externos a Microsoft Graph y mejoran las experiencias inteligentes de Microsoft 365. Es posible que quiera crear un conector personalizado para integrarlo con servicios que no están disponibles como conectores creados por Microsoft. Para crear conectores personalizados, use la API de REST de conectores de Microsoft Graph. Los elementos ingeridos a través de conexiones compiladas con las API consumen la cuota de elementos. Para obtener más información sobre cómo determinar la cuota de artículos que tiene y la compra de una cuota adicional, consulte Requisitos de licencia y precios.

Imagen que muestra los datos externos que llegan a diferentes tipos de conectores a Microsoft Graph

Puede usar la API de conectores de Microsoft Graph para:

  1. Crear y administrar conexiones de datos externos.
  2. Defina y registre el esquema de los tipos de datos externos.
  3. Adquirir elementos de datos externos en Microsoft Graph.
  4. Sincronizar grupos externos.

Crear y administrar conexiones de datos externos.

El recurso externalConnection (API de conexión externa) es un contenedor lógico para los datos externos que puede administrar como una sola unidad.

Para más información, consulte Creación, actualización y eliminación de conexiones en Microsoft Graph.

Definir y registrar el esquema de los tipos de datos externos

El esquema de conexión (API de esquema) determina cómo se usa el contenido en varias experiencias de Microsoft 365. El esquema es una lista plana de todas las propiedades que planea agregar a la conexión junto con sus atributos, etiquetas y alias. Necesita registrar el esquema antes de incluir elementos en Microsoft Graph.

Para más información, consulte Registro y actualización del esquema para la conexión de Microsoft Graph.

Ingesta de elementos de datos externos en Microsoft Graph

Los elementos agregados por la aplicación al servicio Búsqueda de Microsoft se representan mediante el recurso externalItem (API de elemento externo) en Microsoft Graph.

Para más información, consulte Crear, actualizar y eliminar elementos agregados por la aplicación a través de los conectores de Microsoft Graph.

Sincronizar grupos externos

Se puede conceder o denegar el acceso a los elementos del servicio externo a través de ACL a distintos tipos de grupos que no son de Microsoft Entra. Por ejemplo, los elementos de Salesforce pueden tener conjuntos de permisos y perfiles, mientras que los elementos de ServiceNow pueden tener grupos locales. Cuando obtenga estos elementos en Microsoft Graph, debe respetar estas ACL.

Puede usar la API de grupo externo para establecer permisos en los elementos externos ingeridos en Microsoft Graph. Un externalGroup representa una construcción que no es de grupo o grupo de Microsoft Entra (como unidades de negocio, equipos, etc.) y determina los permisos en el contenido del origen de datos externo.

Para obtener más información, consulte Uso de grupos externos para administrar permisos de orígenes de datos de conectores de Microsoft Graph.

Paso siguiente