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 :
- 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.
- Créez une connexion externe. Chaque connexion nécessite un ID, un nom et une description uniques.
- 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 uncompletedstatus. - 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é
externalItemest 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.