Utiliser l’API de connecteurs Microsoft Graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
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 Recherche Microsoft.
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 vérifier l’état de l’opération. Le schéma est provisionné tant que l’état de l’opération est
inprogress. Une fois l’approvisionnement terminé, l’opération retourne uncompletedétat. - 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 10 connexions. (Si vous avez besoin de plus de connexions, remplissez le formulaire De demande.)
- Vous pouvez créer jusqu’à 25 éléments de ressources externalItem 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
- Consultez la vue d’ensemble des connecteurs Microsoft Graph.
- Explorez les méthodes, les propriétés et les relations des ressources externalConnection, schéma, externalItem.
- Consultez la collection postman Microsoft Graph.
- Consultez l’exemple de connecteur de recherche.