Aperçu

Le data store Microsoft Outlook pour Gemini Enterprise vous permet de rechercher et d'effectuer des actions sur vos e-mails, vos agendas, vos contacts et vos fichiers Microsoft 365 (classeurs Excel, documents Word et présentations PowerPoint) stockés dans OneDrive et SharePoint.

Versions de Microsoft Outlook compatibles

Le data store Microsoft Outlook est compatible avec l'API Microsoft Graph v1.0 avec intégration IDP.

Actions compatibles

Lorsque le data store Microsoft Outlook est activé, les utilisateurs finaux peuvent utiliser des commandes en langage naturel dans Gemini Enterprise pour effectuer les actions suivantes.

Action	Description
Créer un contact	Crée un contact dans Microsoft Outlook.
Créer un événement	Crée un événement.
Télécharger les pièces jointes	Télécharge une pièce jointe à partir d'un e-mail Microsoft Outlook.
Envoyer le message	Envoie un e-mail. Cela inclut l'envoi d'e-mails avec des pièces jointes.
Modifier un contact	Modifie un contact existant dans Microsoft Outlook.
Modifier un événement	Modifie un événement existant.
Lire des données Excel	Répertorie les classeurs, lit les feuilles de calcul, les tableaux et les lignes des fichiers Excel (.xlsx) stockés dans OneDrive ou SharePoint.
Modifier des données Excel	Ajoute et modifie des lignes, crée des feuilles de calcul et des tableaux, et ajoute des colonnes clés dans les fichiers Excel (.xlsx) stockés dans OneDrive ou SharePoint.
Créer un document Word	Crée un document Word (.docx) dans le OneDrive de l'utilisateur.
Convertir un document Word au format PDF	Convertit un document Word (.docx) stocké dans OneDrive ou SharePoint au format PDF.
Créer une présentation PowerPoint	Crée une présentation PowerPoint (.pptx) dans le OneDrive de l'utilisateur.
Convertir une présentation PowerPoint au format PDF	Convertit une présentation PowerPoint (.pptx) stockée dans OneDrive ou SharePoint au format PDF.

Remarques:

• D'autres actions en lecture seule sont également disponibles.
• La taille maximale des fichiers à importer et à télécharger dans Gemini Enterprise est de 25 Mo.
• Les actions Excel, Word et PowerPoint nécessitent des autorisations supplémentaires de l'API Microsoft Graph sur les fichiers OneDrive ou SharePoint avec lesquels l'utilisateur travaille. Pour en savoir plus, consultez [Autorisations requises](#required-permissions).

Autorisations requises

Le tableau suivant présente les autorisations requises pour la recherche et les actions Microsoft Outlook.

Mode de connexion	Autorisation	Purpose
Recherche unifiée	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	(Déléguée) Permet au data store de lire la boîte aux lettres de l'utilisateur connecté, les e-mails des boîtes aux lettres partagées, les événements d'agenda et les contacts.
Ingestion de données	Calendars.Read	(Application) Permet au data store de lire les événements de tous les agendas.
	Calendars.ReadBasic.All	(Application) Permet au data store de lire les événements de tous les agendas, à l'exception des propriétés telles que le corps, les pièces jointes et les extensions.
	Contacts.Read	(Application) Permet au data store de lire tous les contacts dans toutes les boîtes aux lettres.
	Mail.Read	(Application) Permet au data store de lire les e-mails dans toutes les boîtes aux lettres.
	Mail.ReadBasic	(Application) Permet au data store de lire les propriétés de base des e-mails dans toutes les boîtes aux lettres. Inclut toutes les propriétés, à l'exception du corps, de previewBody, des pièces jointes et de toutes les propriétés étendues.
	Mail.ReadBasic.All	(Application) Permet au data store de lire les propriétés de base des e-mails dans toutes les boîtes aux lettres. Inclut toutes les propriétés, à l'exception du corps, de previewBody, des pièces jointes et de toutes les propriétés étendues.
	User.Read	(Déléguée) Permet au data store de lire le profil des utilisateurs connectés.
	User.Read.All	(Application) Permet au data store de lire l'ensemble complet des propriétés de profil, des rapports et des responsables des autres utilisateurs de votre organisation.
	User.ReadBasic.All	(Application) Permet au data store de lire un ensemble de base de propriétés de profil des autres utilisateurs de votre organisation.
Actions	Mail.Send	(Déléguée) Permet au data store d'envoyer des e-mails en tant qu'utilisateurs de l'organisation.
	Calendars.ReadWrite	(Déléguée) Permet au data store de créer, lire, modifier et supprimer des événements dans les agendas des utilisateurs.
	Contacts.ReadWrite	(Déléguée) Permet au data store de créer, lire, modifier et supprimer des contacts utilisateur.
	User.Read	(Déléguée) Permet au data store de lire le profil des utilisateurs connectés.
Productivité des fichiers (Excel, Word, PowerPoint)	Files.Read.All	(Déléguée) Uniquement suffisant pour les outils qui lisent les métadonnées des fichiers ou téléchargent le contenu des fichiers : répertorier les classeurs Excel, lire les métadonnées des classeurs Excel et convertir les documents Word (.docx) ou PowerPoint (.pptx) au format PDF. Lit tous les fichiers auxquels l'utilisateur peut accéder, y compris les fichiers stockés sur les sites SharePoint auxquels l'utilisateur a accès. Non suffisant pour les opérations de contenu des classeurs Excel (voir la ligne suivante).
	Files.ReadWrite.All	(Déléguée) Requis pour toutes les opérations de contenu des classeurs Excel (lecture et écriture), y compris obtenir des feuilles de calcul, obtenir des tableaux, obtenir des lignes, obtenir une ligne, créer des feuilles de calcul et des tableaux, ajouter et modifier des lignes, et ajouter des colonnes clés. Conformément à la documentation de référence de l'API Microsoft Graph pour ces points de terminaison (par exemple, worksheet-list, table-list, tablerow-list), l'autorisation déléguée acceptée est Files.ReadWrite. Files.ReadWrite.All accorde la même fonctionnalité sur tous les lecteurs auxquels l'utilisateur peut accéder (OneDrive personnel et toute bibliothèque de documents SharePoint à laquelle l'utilisateur a accès). Également requis pour créer des documents Word et PowerPoint dans le OneDrive de l'utilisateur.
	User.Read	(Déléguée) Requis pour résoudre l'emplacement OneDrive de l'utilisateur connecté pour les opérations sur les fichiers.
Tâches (listes de tâches et tâches Outlook)	Tasks.Read	(Déléguée) Requis pour les opérations de lecture sur les listes de tâches et les tâches Outlook de l'utilisateur connecté (list task lists, list tasks, get task).
	Tasks.ReadWrite	(Déléguée) Requis pour les opérations d'écriture : créer, modifier et supprimer des tâches dans les listes de tâches Outlook de l'utilisateur connecté.
Utilisateurs et annuaire (énumération déléguée)	User.ReadBasic.All	(Déléguée) Requis pour les outils qui énumèrent ou recherchent les profils d'autres utilisateurs de l'organisation (Get User, List Users et outils qui fonctionnent sur les boîtes aux lettres ou les agendas d'autres utilisateurs).

Remarque : Les actions de productivité des fichiers ci-dessus nécessitent que l'administrateur du locataire de l'utilisateur accorde les autorisations correspondantes de l'API Microsoft Graph lors de l'enregistrement de l'application OAuth. Si ces autorisations ne sont pas accordées, les requêtes adressées aux outils Excel, Word et PowerPoint échouent avec une erreur HTTP 403 accessDenied. Recommandé : accordez Files.ReadWrite.All, qui couvre tous les outils de productivité des fichiers. Si vous n'avez besoin que de la conversion au format PDF de Word ou PowerPoint et de la liste/des métadonnées des classeurs Excel (sans accès aux feuilles de calcul, aux tableaux ni aux lignes), Files.Read.All seul suffit. Pour les opérations basées sur driveItem (conversion au format PDF de Word/PowerPoint, liste des classeurs Excel, lecture des métadonnées des classeurs Excel), Microsoft Graph documente également Sites.Read.All ou Sites.ReadWrite.All comme alternatives acceptées (voir driveItem-get et driveItem-get-content-format). Pour connaître les étapes de configuration, consultez Configurer Microsoft Outlook et définir les autorisations nécessaires.

Remarque : Si Tasks.Read ou Tasks.ReadWrite sont manquants, les outils de tâches Outlook échouent avec l'erreur HTTP 403 notAllowed. Si User.ReadBasic.All (déléguée) est manquante, les outils de recherche d'utilisateur échouent avec l'erreur HTTP 403 Authorization_RequestDenied. Les locataires qui ont besoin d'un accès utilisateur plus privilégié peuvent remplacer User.Read.All ou Directory.Read.All par User.ReadBasic.All.

Pour savoir comment ajouter les autorisations pour Microsoft Outlook, consultez Configurer Microsoft Outlook et définir les autorisations nécessaires.

Limites de débit pour l'ingestion de données

La limite de volume de requêtes est de 10 000 requêtes API par période de 10 minutes. Ces limites de débit s'appliquent exclusivement au data store Microsoft Outlook lorsque vous choisissez d'utiliser l'ingestion comme mode de connexion.

Limites

Cette section décrit les problèmes et limites connus qui peuvent affecter votre utilisation du data store Microsoft Outlook.

• Lorsque vous créez une application ou que vous ajoutez un data store à une application existante, il est recommandé d'associer un seul data store à des actions appartenant à un seul type de connecteur.

• L'application d'un périmètre VPC Service Controls aux datastores Microsoft Outlook existants n'est pas acceptée. Pour appliquer VPC Service Controls, vous devez supprimer et recréer les datastores. Pour en savoir plus sur VPC Service Controls et sur l'utilisation des actions après l'activation de VPC Service Controls, consultez Sécuriser votre application avec VPC Service Controls.

• Le data store Microsoft Outlook n'est compatible qu'avec les global, us, et eu emplacements.

• Le data store Microsoft Outlook peut traiter une transaction par seconde et par nœud, et limite les transactions au-delà de ce seuil.

• La capacité du data store Microsoft Outlook à réessayer en cas d'erreur de dépassement de la limite de débit dépend de la réception d'une valeur retry-after de l'API Microsoft Graph, qui n'est fournie que pour le data store Outlook. Le nombre de tentatives par défaut est de trois.

• Le débit du data store Microsoft Outlook est limité par les restrictions d'appels d'API imposées par Microsoft Graph. Les limites s'appliquent à chaque combinaison d'ID d'application et de boîte aux lettres, c'est-à-dire à une application spécifique accédant à une boîte aux lettres d'utilisateur ou de groupe spécifique. Le dépassement de la limite pour une boîte aux lettres n'affecte pas la capacité de l'application à accéder à une autre boîte aux lettres.

• Le data store Microsoft Outlook est mappé un à un avec un seul ID de locataire Azure. Il ne peut pas s'étendre sur plusieurs locataires Microsoft 365 isolés au sein d'une organisation multilocataire. Vous devez créer un data store dédié pour chaque locataire distinct.

• Les boîtes aux lettres doivent être entièrement migrées vers Exchange Online. Les boîtes aux lettres hébergées sur site dans un environnement Exchange hybride ne sont pas accessibles via l'API Microsoft Graph. Les tentatives d'interrogation de ces boîtes aux lettres ou de boîtes aux lettres inter-locataires peuvent entraîner une erreur MailboxNotEnabledForRESTAPI.

• Le data store Microsoft Outlook peut traiter une transaction par seconde et par nœud, et limite les transactions au-delà de ce seuil.

Étape suivante

• Pour créer et configurer un data store avec Microsoft Outlook, consultez Configurer un datastore Microsoft Outlook.