Uso de la API de conectores de Microsoft Graph

  • Artículo

Puede usar conectores de Microsoft Graph para traer datos de servicios externos a Microsoft Graph. La API de conectores de Microsoft Graph permite indexar datos externos con el fin de potenciar experiencias inteligentes en Microsoft 365, como Copilot y Microsoft Búsqueda.

Las solicitudes a los datos de índice se realizan en nombre de una aplicación sin la presencia de un usuario que ha iniciado sesión a través de un token de acceso con permiso de aplicación.

Compilación de un conector personalizado de Microsoft Graph

La creación de un conector personalizado de Microsoft Graph implica cuatro pasos:

  1. Cree un registro de aplicación de Entra ID (anteriormente conocido como Azure Active Directory). Junto con la solicitud a Microsoft Graph, envía el nombre del registro de la aplicación y los permisos de API que necesita la aplicación. Microsoft Graph responde con información sobre el registro de la aplicación recién creada.
  2. Cree una conexión externa. Cada conexión requiere un identificador, un nombre y una descripción únicos.
  3. Cree el esquema para la conexión externa. El esquema define la forma de contenido externo que se va a ingerir a través de esta conexión de Microsoft Graph. La creación del esquema es una operación de ejecución prolongada. Después de enviar el esquema para crear la conexión, Microsoft Graph responde con una dirección URL que puede usar para comprobar el estado de la operación. El esquema se aprovisiona siempre que el estado de la operación sea inprogress. Cuando se complete el aprovisionamiento, la operación devolverá un completed estado.
  4. Ingerir contenido externo. Para cada elemento externo, extráigalo del repositorio de contenido de origen, transfórelo para que coincida con el esquema de la conexión externa y envíelo a Microsoft Graph como un elemento externo. Junto con el elemento, incluya información sobre quién puede acceder a él, también conocida como lista de control de acceso (ACL).

A continuación se muestra un diagrama de secuencia que muestra los cuatro pasos para crear un conector de Microsoft Graph.

Diagrama que muestra los cuatro pasos para crear un conector de Microsoft Graph

Casos de uso comunes

En la tabla siguiente se enumeran los casos de uso comunes para la API de conectores de Microsoft Graph.

Casos de uso Recursos de REST Vea también
Acciones de configuración
Crear, actualizar o eliminar una conexión externalConnection métodos externalConnection
Registrar un esquema para los datos externos esquema métodos de esquema
Acciones de indexación
Agregar, actualizar o eliminar un elemento personalizado en el índice externalItem métodos externalItem

Limitaciones conocidas

A continuación las limitaciones conocidas actuales:

  • Las organizaciones están limitadas a un máximo de 30 conexiones. (Si necesita más conexiones, complete el formulario de solicitud).
  • Puede crear hasta 25 externalItem elementos de recursos por segundo.
  • Una aplicación está limitada a 25 operaciones simultáneas en una conexión.
  • Las conexiones tienen un límite de capacidad de 5 000 000 de elementos o ~350 GB de datos.
  • El tamaño máximo de un externalItem entidad es 4 MB.

Pasos siguientes