Aperçu

Le data store Microsoft Outlook pour Gemini Enterprise vous permet de rechercher des éléments 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.

Remarque : Lorsque vous utilisez la recherche fédérée ou des connecteurs fédérés, votre chaîne de requête est envoyée à tous les backends de recherche tiers activés. La chaîne de requête envoyée à un système tiers peut contenir des parties des données de votre requête de recherche et de l'historique de la conversation. Le système tiers peut associer la requête à votre identité. Une fois les données transférées vers le système tiers, elles sont soumises aux conditions d'utilisation et aux règles de confidentialité de ce système, et non à celles de Google Cloud.

Versions de Microsoft Outlook compatibles

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

Action compatible

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éation d'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	Met à jour un contact existant dans Microsoft Outlook.
Mettre à jour un événement	Met à jour un événement existant.
Lire des données Excel	Liste 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 met à jour 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 en 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 un fichier 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é) Permet au data store de lire la boîte aux lettres, les e-mails des boîtes aux lettres partagées, les événements d'agenda et les contacts de l'utilisateur connecté.
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 de body, previewBody, attachments et des 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 de body, previewBody, attachments et des 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 des propriétés de profil, des rapports et des gestionnaires 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 d'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é) Permet au data store de créer, lire, modifier et supprimer des événements dans les agendas des utilisateurs.
	Contacts.ReadWrite	(Délégué) Permet au data store de créer, lire, mettre à jour et supprimer les 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) Suffisant uniquement pour les outils qui lisent les métadonnées des fichiers ou téléchargent leur contenu : lister 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 ceux stockés sur les sites SharePoint auxquels il a accès. Insuffisant pour les opérations sur le contenu des classeurs Excel (voir la ligne suivante).
	Files.ReadWrite.All	(Déléguée) Obligatoire pour toutes les opérations de contenu de classeur Excel (lecture et écriture), y compris l'obtention de feuilles de calcul, de tableaux, de lignes et de lignes, la création de feuilles de calcul et de tableaux, l'ajout et la mise à jour de lignes, et l'ajout de colonnes clés. Selon 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 les mêmes droits d'accès à tous les lecteurs auxquels l'utilisateur peut accéder (son OneDrive personnel et toutes les bibliothèques de documents SharePoint auxquelles il 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) Nécessaire 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é) Requis pour les opérations de lecture sur les listes de tâches et les tâches Outlook de l'utilisateur connecté (lister les listes de tâches, lister les tâches, obtenir une tâche).
	Tasks.ReadWrite	(Déléguée) Obligatoire pour les opérations d'écriture : création, mise à jour et suppression de 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) Obligatoire 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é liées aux fichiers ci-dessus nécessitent que l'administrateur du locataire de l'utilisateur accorde les autorisations correspondantes de l'API Microsoft Graph sur l'enregistrement de l'application OAuth. Si ces autorisations ne sont pas accordées, les requêtes envoyées aux outils Excel, Word et PowerPoint échouent et renvoient une erreur HTTP 403 accessDenied. Recommandé : accordez l'autorisation Files.ReadWrite.All, qui couvre tous les outils de productivité liés aux fichiers. Si vous n'avez besoin que de la conversion de fichiers Word ou PowerPoint au format PDF, 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 suffit. Pour les opérations basées sur driveItem (conversion Word/PowerPoint au format PDF, 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 la procédure de configuration, consultez Configurer Microsoft Outlook et définir les autorisations nécessaires.

Remarque : L'absence de Tasks.Read ou de Tasks.ReadWrite entraîne l'échec des outils de tâches Outlook avec l'erreur HTTP 403 notAllowed. L'absence de User.ReadBasic.All (délégué) entraîne l'échec des outils de recherche d'utilisateurs avec l'erreur HTTP 403 Authorization_RequestDenied. Les locataires qui ont besoin d'un accès utilisateur avec des droits plus élevés peuvent remplacer User.ReadBasic.All par User.Read.All ou Directory.Read.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 les limites connus qui peuvent affecter votre utilisation du data store Microsoft Outlook.

• Lorsque vous créez une application ou ajoutez un data store à une application existante, nous vous recommandons d'associer un seul data store aux actions appartenant à un seul type de connecteur.

• Il n'est pas possible d'appliquer un périmètre VPC Service Controls aux data stores Microsoft Outlook existants. 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 emplacements global, us et eu.

• 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'erreurs 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'empêche pas l'application d'accéder à une autre boîte aux lettres.

• Le data store Microsoft Outlook est associé à un seul ID de locataire Azure. Il ne peut pas s'étendre sur plusieurs locataires Microsoft 365 isolés au sein d'une organisation mutualisée. 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. Toute tentative d'interroger ces boîtes aux lettres ou des boîtes aux lettres inter-locataires peut 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.

Étapes suivantes

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