Utiliser l’API de connecteurs Microsoft Graph

Vous pouvez utiliser des connecteurs Microsoft Graph pour importer des données de services externes dans Microsoft Graph. L’API de connecteurs Microsoft Graph vous permet d’indexer des données externes afin d’alimenter des expériences intelligentes dans Microsoft 365, telles que Copilot et Microsoft Recherche.

Les demandes d’indexation des données sont effectuées pour le compte d’une application sans la présence d’un utilisateur connecté via un jeton d’accès avec l’autorisation de l’application.

Créer un connecteur Microsoft Graph personnalisé

La création d’un connecteur Microsoft Graph personnalisé implique quatre étapes :

1. Créez une inscription d’application d’ID Entra (anciennement appelée Azure Active Directory). En plus de la demande adressée à Microsoft Graph, vous envoyez le nom de l’inscription de l’application et des autorisations d’API dont votre application a besoin. Microsoft Graph répond avec des informations sur l’inscription de l’application nouvellement créée.
2. Créez une connexion externe. Chaque connexion nécessite un ID, un nom et une description uniques.
3. Créez le schéma pour la connexion externe. Le schéma définit la forme du contenu externe que vous allez ingérer via cette connexion Microsoft Graph. La création du schéma est une opération de longue durée. Une fois que vous avez envoyé le schéma pour créer la connexion, Microsoft Graph répond avec une URL que vous pouvez utiliser pour case activée le status de l’opération. Le schéma est en cours d’approvisionnement tant que l’opération status est inprogress. Une fois l’approvisionnement terminé, l’opération retourne un completed status.
4. Ingérer du contenu externe. Pour chaque élément externe, extrayez-le du référentiel de contenu source, transformez-le pour qu’il corresponde au schéma de votre connexion externe et envoyez-le à Microsoft Graph en tant qu’élément externe. En plus de l’élément, incluez des informations sur les personnes autorisées à y accéder, également appelée liste de contrôle d’accès (ACL).

Voici un diagramme de séquence qui illustre les quatre étapes de création d’un connecteur Microsoft Graph.

Cas d’utilisation courants

Le tableau suivant répertorie les cas d’usage courants pour l’API de connecteurs Microsoft Graph.

Cas d'utilisation	Ressources REST	Voir aussi
Conseils de configuration
Créer, mettre à jour ou supprimer une collection	externalConnection	Méthodes externalConnection
Enregistrer un schéma pour les données externes	schéma	méthodes de schéma
Actions d’indexation
Ajouter, mettre à jour ou supprimer un élément personnalisé dans l’index	externalItem	Méthodes externalItem

Limitations connues

Les éléments suivants sont les limitations connues à ce jour :

• Les organisations sont limitées à un maximum de 30 connexions. (Si vous avez besoin de plus de connexions, remplissez le formulaire De demande.)
• Vous pouvez créer jusqu’à 25 externalItem éléments de ressources par seconde.
• Une application est limitée à 25 opérations simultanées sur une connexion.
• Les connexions ont une limite de capacité de 5 000 000 éléments ou ~ 350 Go de données.
• La taille maximale d'une entité externalItem est de 4 Mo.

Étapes suivantes

• Consulter la Vue d’ensemble de l’API Recherche Microsoft.
• Explorez les méthodes, les propriétés et les relations des ressources externalConnection, schéma, externalItem.
• Réglez la collection postman Microsoft Graph (en savoir plus)
• Consulter l’exemple de connecteur de recherche depuis GitHub.