Uso de la API de conectores de Microsoft Graph
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:
- 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.
- Cree una conexión externa. Cada conexión requiere un identificador, un nombre y una descripción únicos.
- 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á uncompletedestado. - 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.
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
externalItemelementos 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
externalItementidad es 4 MB.
Pasos siguientes
- Consulte la Información general sobre la API de Búsqueda de Microsoft
- Desplácese por los métodos, propiedades y relaciones de la externalConnection, esquemay externalItem recursos.
- Consulte la colección de postman de Microsoft Graph (obtener más información)
- Descargue el conector de búsqueda de ejemplo desde GitHub