Le connecteur Microsoft 365 pour Gemini Enterprise vous permet de rechercher des données et d'agir sur celles-ci dans Microsoft 365 à partir d'un seul connecteur : sites SharePoint, fichiers OneDrive, messagerie Outlook, agendas Outlook, contacts et Microsoft Teams. Le connecteur atteint toutes ces surfaces via l'API Microsoft Graph.
Comme un seul connecteur couvre toutes les surfaces Microsoft 365, vous n'avez pas besoin de créer un data store distinct pour SharePoint, OneDrive, Outlook et Teams.
Le connecteur accepte deux méthodes d'authentification OAuth 2.0 :
- OAuth géré parGoogle(par défaut) : le connecteur utilise une application Microsoft Entra gérée par Google . Vous n'enregistrez pas votre propre application et ne fournissez pas d'ID client ni de code secret du client.
- Utiliser votre propre application : enregistrez votre propre application Microsoft Entra, puis fournissez son ID de locataire, son ID client et son code secret du client lorsque vous configurez le datastore.
Pour en savoir plus, consultez Configuration de Microsoft 365.
Action compatible
Lorsque le connecteur Microsoft 365 est activé, les utilisateurs finaux peuvent utiliser des commandes en langage naturel dans Gemini Enterprise pour effectuer les actions suivantes. Les actions sont regroupées par produit Microsoft 365 sur lequel elles agissent, ce qui correspond à la façon dont elles sont regroupées lorsque vous sélectionnez des actions dans la consoleGoogle Cloud . Pour chaque action, les tableaux indiquent si elle ne fait que lire des données ou si elle apporte également des modifications, ainsi que les autorisations Microsoft Graph déléguées dont elle a besoin. Pour savoir comment les autorisations sont demandées et accordées, consultez Autorisations.
Utilisateurs et groupes
| Action | Type | Description | Autorisations requises |
|---|---|---|---|
| Ajouter un membre au groupe | Écriture | Ajoute un utilisateur en tant que membre d'un groupe. | GroupMember.ReadWrite.All |
| Ajouter un propriétaire de groupe | Écriture | Ajoute un utilisateur en tant que propriétaire d'un groupe. | Group.ReadWrite.All |
| Créer un groupe | Écriture | Crée un groupe Microsoft 365. | Group.ReadWrite.All |
| Obtenir mon profil | Lecture seule | Récupère le profil de l'utilisateur connecté, y compris l'adresse e-mail associée à son compte Microsoft. | User.Read |
| Obtenir le profil utilisateur | Lecture seule | Récupère le profil d'un utilisateur dans l'annuaire. | User.ReadBasic.All |
| Obtenir le profil professionnel de l'utilisateur | Lecture seule | Récupère l'intitulé de poste, le service, le bureau, les numéros de téléphone, le responsable et les collaborateurs directs d'un utilisateur. | User.Read.All |
| Répertorier les membres du groupe | Lecture seule | Répertorie les membres directs d'un groupe dans l'annuaire. | Group.ReadBasic.AllUser.ReadBasic.All |
| Lister les propriétaires de groupe | Lecture seule | Répertorie les propriétaires d'un groupe dans l'annuaire. | GroupMember.Read.AllUser.ReadBasic.All |
| Répertorier les groupes | Lecture seule | Recherche des groupes dans l'annuaire par nom et renvoie l'ID de chaque groupe. | Group.ReadBasic.All |
| Rechercher des personnes dans l'annuaire | Lecture seule | Recherche des personnes dans l'annuaire de l'organisation par nom ou adresse e-mail. | User.ReadBasic.All |
| Mettre à jour le groupe | Écriture | Met à jour le nom, la description ou la visibilité d'un groupe. | Group.ReadWrite.All |
SharePoint et OneDrive
| Action | Type | Description | Autorisations requises |
|---|---|---|---|
| Obtenir une plage Excel | Lecture seule | Lit les valeurs des cellules d'un bloc de cellules d'une feuille de calcul, y compris les cellules situées en dehors d'un tableau. | Files.Read.All |
| Obtenir une ligne de tableau Excel | Lecture seule | Lit une ligne d'un tableau dans un classeur Excel, avec les en-têtes de colonne du tableau. | Files.Read.All |
| Obtenir les lignes d'un tableau Excel | Lecture seule | Lit les lignes de données d'un tableau dans un classeur Excel, avec les en-têtes de colonne du tableau. | Files.Read.All |
| Lister les tableaux Excel | Lecture seule | Cette action liste les tableaux mis en forme dans un classeur Excel et la feuille de calcul sur laquelle chacun se trouve. | Files.Read.All |
| Obtenir les propriétés d'un classeur Excel | Lecture seule | Lit les propriétés d'un fichier de classeur Excel : nom, taille, URL et auteur de la dernière modification. | Files.Read.All |
| Obtenir une feuille de calcul Excel | Lecture seule | Lit une feuille de calcul d'un classeur Excel et l'étendue des données qu'elle contient. | Files.Read.All |
| Lister les feuilles de calcul Excel | Lecture seule | Répertorie les feuilles de calcul d'un classeur Excel, dans l'ordre des onglets. | Files.Read.All |
| Lister les classeurs Excel | Lecture seule | Recherche des classeurs Excel dans les sites OneDrive et SharePoint auxquels l'utilisateur peut accéder. | Sites.Read.AllFiles.Read.All |
| Archiver le document | Écriture | Archive un document, libère son verrou de modification et le rend disponible pour d'autres utilisateurs. | Files.ReadWrite.All |
| Réserver le document | Écriture | Extrait un document et le verrouille pour une modification exclusive. | Files.ReadWrite.All |
| Copier le fichier | Écriture | Copie un fichier vers un nouvel emplacement. | Files.ReadWrite.All |
| Copier le dossier | Écriture | Copie un dossier vers un nouvel emplacement. | Files.ReadWrite.All |
| Créer un fichier | Écriture | Crée un fichier avec un nom donné dans un dossier. N'écrase jamais un fichier existant. Pour cela, utilisez Remplacer le contenu du fichier. | Files.ReadWrite.All |
| Créer un dossier | Écriture | Crée un dossier dans un dossier existant. | Files.ReadWrite.All |
| Créer un lien de partage | Écriture | Crée un lien partageable vers un fichier ou un dossier. | Files.ReadWrite.All |
| Supprimer le paiement | Écriture | Annule l'extraction d'un document et supprime toutes les modifications en attente. | Files.ReadWrite.All |
| Obtenir un fichier ou un dossier par URL | Lecture seule | Recherche le fichier ou le dossier vers lequel pointe un lien SharePoint ou OneDrive, afin qu'il puisse être lu ou traité. | Files.Read.All |
| Télécharger le contenu du fichier | Lecture seule | Télécharge le contenu brut d'un fichier stocké dans un drive. | Files.Read.All |
| Obtenir mon OneDrive | Lecture seule | Récupère le compte OneDrive de l'utilisateur connecté, afin que les fichiers puissent être enregistrés ou listés au niveau supérieur, et indique son quota de stockage. | Files.Read.All |
| Affichage du contenu du dossier | Lecture seule | Répertorie les fichiers et les dossiers d'un dossier dans un drive. | Files.Read.All |
| Lister les autorisations de fichiers | Lecture seule | Répertorie les autorisations de partage définies sur un fichier ou un dossier. | Files.Read.All |
| Déplacer le fichier | Écriture | Déplace un fichier vers un autre dossier. | Files.ReadWrite.All |
| Déplacer le dossier | Écriture | Déplace un dossier vers un autre dossier parent. | Files.ReadWrite.All |
| Renommer le fichier | Écriture | Renomme un fichier. | Files.ReadWrite.All |
| Renommer le dossier | Écriture | Renomme un dossier. | Files.ReadWrite.All |
| Remplacer le contenu du fichier | Écriture | Remplace l'intégralité du contenu d'un fichier existant. Pour créer un fichier, utilisez Créer un fichier. | Files.ReadWrite.All |
| Envoyer une invitation de partage | Écriture | Envoie une invitation de partage pour un fichier ou un dossier. | Files.ReadWrite.All |
| Mettre à jour les propriétés d'un fichier ou d'un dossier | Écriture | Met à jour les propriétés d'un fichier ou d'un dossier (nom, description, dossier parent). | Files.ReadWrite.All |
| Créer une liste SharePoint | Écriture | Crée une liste sur un site SharePoint. | Sites.Manage.All |
| Créer un élément de liste | Écriture | Crée un élément dans une liste SharePoint. | Sites.ReadWrite.All |
| Créer une page SharePoint | Écriture | Crée une page sur un site SharePoint. | Sites.ReadWrite.All |
| Obtenir un élément de liste | Lecture seule | Récupère une seule ligne d'une liste SharePoint, avec ses valeurs de colonne. | Sites.Read.All |
| Obtenir le contenu d'une page SharePoint | Lecture seule | Récupère le corps HTML d'une page SharePoint. | Sites.Read.All |
| Lister les éléments de liste | Lecture seule | Lit les lignes d'une liste SharePoint, avec les valeurs de colonne de chaque ligne. | Sites.Read.All |
| Lister les listes SharePoint | Lecture seule | Répertorie les listes SharePoint d'un site, y compris l'ID et le modèle de chaque liste. | Sites.Read.All |
| Lister les pages SharePoint | Lecture seule | Répertorie les pages d'un site SharePoint, avec le titre, l'URL et l'état de publication de chaque page. | Sites.Read.All |
| Rechercher dans SharePoint et OneDrive | Lecture seule | Recherche dans les sites, les pages, les éléments de liste SharePoint et les fichiers OneDrive auxquels l'utilisateur a accès. | Sites.Read.AllFiles.Read.All |
| Mettre à jour la liste SharePoint | Écriture | Met à jour les propriétés d'une liste SharePoint (nom, description). | Sites.Manage.All |
| Mettre à jour l'élément de la liste | Écriture | Met à jour les champs d'un élément de liste SharePoint existant. | Sites.ReadWrite.All |
| Mettre à jour la page SharePoint | Écriture | Met à jour le titre ou le nom de fichier d'une page SharePoint. | Sites.ReadWrite.All |
Outlook
| Action | Type | Description | Autorisations requises |
|---|---|---|---|
| Ajouter un rattachement | Écriture | Ajoute une pièce jointe à un e-mail ou à un événement d'agenda existant. | Mail.ReadWriteCalendars.ReadWrite |
| Créer l'agenda | Écriture | Crée un agenda dans la boîte aux lettres de l'utilisateur. | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| Créer un contact | Écriture | Crée un contact dans le dossier "Contacts" de l'utilisateur. | Contacts.ReadWrite |
| Créer un brouillon de message | Écriture | Crée un brouillon d'e-mail dans la boîte aux lettres de l'utilisateur. | Mail.ReadWriteMail.ReadWrite.Shared |
| Créer un événement d'agenda | Écriture | Crée un événement dans l'agenda de l'utilisateur. | Calendars.ReadWrite |
| Créer un brouillon de réponse | Écriture | Crée un brouillon de réponse à l'expéditeur d'un e-mail existant. | Mail.ReadWriteMail.ReadWrite.Shared |
| Trouver des horaires de réunion | Lecture seule | Suggère des horaires de réunion en fonction de la disponibilité des participants. | Calendars.Read.Shared |
| Transférer le message | Écriture | Transfère un e-mail existant aux destinataires spécifiés. | Mail.Send |
| Obtenir la pièce jointe d'un e-mail | Lecture seule | Récupère les octets d'une pièce jointe d'un message dans la boîte aux lettres de l'utilisateur. | Mail.Read |
| Obtenir des réponses automatiques | Lecture seule | Récupère le paramètre de réponse automatique (absence du bureau) d'Outlook de l'utilisateur. | MailboxSettings.Read |
| Obtenir un événement d'agenda | Lecture seule | Récupère un événement de l'agenda Outlook de l'utilisateur, y compris les réponses des participants et les ID des pièces jointes. | Calendars.Read |
| Obtenir la pièce jointe à l'événement d'agenda | Lecture seule | Récupère les octets d'une pièce jointe d'un événement dans l'agenda de l'utilisateur. | Calendars.Read |
| Obtenir un e-mail | Lecture seule | Récupère un seul message de la boîte aux lettres de l'utilisateur. | Mail.Read |
| Obtenir la disponibilité du planning | Lecture seule | Récupère la disponibilité (libre/occupé) des utilisateurs, des salles ou des équipements sur une période donnée. | Calendars.Read |
| Lister les événements d'agenda | Lecture seule | Répertorie les événements de l'agenda de l'utilisateur sur une période donnée. | Calendars.Read |
| Lister les agendas | Lecture seule | Répertorie les agendas de la boîte aux lettres de l'utilisateur. | Calendars.Read |
| Lister les catégories Outlook | Lecture seule | Répertorie les catégories (libellés) de la liste de catégories Outlook de l'utilisateur. | MailboxSettings.Read |
| Répertorier les contacts | Lecture seule | Répertorie ou recherche les contacts dans le carnet d'adresses Outlook de l'utilisateur. | Contacts.Read |
| Lister les règles de la boîte de réception | Lecture seule | Répertorie les règles de la boîte de réception Outlook de l'utilisateur. | MailboxSettings.Read |
| Lister les dossiers de messagerie | Lecture seule | Répertorie les dossiers de messagerie dans la boîte aux lettres de l'utilisateur. | Mail.ReadBasic |
| Lister les messages d'un dossier | Lecture seule | Répertorie les messages de l'un des dossiers de messagerie de l'utilisateur, comme la boîte de réception ou les éléments envoyés. | Mail.Read |
| Lister ou rechercher une boîte aux lettres partagée | Lecture seule | Répertorie ou recherche les messages d'une boîte aux lettres partagée ou déléguée à laquelle l'utilisateur a accès. | Mail.Read.Shared |
| Déplacer le message | Écriture | Déplace un e-mail vers un autre dossier de messagerie. | Mail.ReadWrite |
| Répondre à tous au message | Écriture | Répond à un e-mail existant, à son expéditeur et à tous les autres destinataires, en conservant la réponse dans la conversation d'origine. | Mail.Send |
| Répondre au message | Écriture | Répond à un e-mail existant, à son expéditeur, en conservant la réponse dans la conversation d'origine. | Mail.Send |
| Répondre à l'événement | Écriture | Répond à une invitation à une réunion (accepte, accepte provisoirement ou refuse). | Calendars.ReadWrite |
| Rechercher dans les e-mails | Lecture seule | Recherche dans les e-mails Outlook de l'utilisateur par mot clé. | Mail.Read |
| Rechercher un e-mail dans un dossier | Lecture seule | Recherche des messages dans l'un des dossiers de messagerie de l'utilisateur, y compris les sous-dossiers tels que "Boîte de réception/Factures", par mot clé, expéditeur ou objet. | Mail.Read |
| Rechercher des événements d'agenda | Lecture seule | Recherche les événements d'agenda Outlook de l'utilisateur par mot clé. | Calendars.Read |
| Envoyer le brouillon de message | Écriture | Envoie un brouillon d'e-mail existant. | Mail.Send |
| Envoyer le message | Écriture | Rédige et envoie un nouvel e-mail. | Mail.Send |
| Mettre à jour l'agenda | Écriture | Mettre à jour les propriétés d'un agenda existant (nom, couleur ou état par défaut). | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| Modifier un contact | Écriture | Met à jour les propriétés d'un contact existant. | Contacts.ReadWrite |
| Mettre à jour l'événement | Écriture | Met à jour les propriétés d'un événement d'agenda existant. | Calendars.ReadWrite |
| Modifier le message | Écriture | Met à jour les propriétés d'un e-mail existant (par exemple, marquer comme lu, modifier les indicateurs ou l'importance). | Mail.ReadWrite |
| Répertorier les listes de tâches | Lecture seule | Répertorie les listes de tâches Microsoft To Do (tâches Outlook) de l'utilisateur. | Tasks.Read |
| Répertorier les tâches | Lecture seule | Répertorie les tâches de l'une des listes Microsoft To Do (tâches Outlook) de l'utilisateur. | Tasks.Read |
Équipes
| Action | Type | Description | Autorisations requises |
|---|---|---|---|
| Ajouter un membre au canal | Écriture | Ajoute un utilisateur à un canal Teams privé ou partagé. | ChannelMember.ReadWrite.All |
| Créer un canal | Écriture | Crée un canal dans une équipe Teams. | Channel.Create |
| Créer un chat | Écriture | Crée une discussion Teams (discussion privée, de groupe ou de réunion). | Chat.Create |
| Créer une réunion | Écriture | Crée une réunion Teams en ligne. | OnlineMeetings.ReadWrite |
| Créer un groupe de planification | Écriture | Crée un groupe de planification dans un planning Teams. | Schedule.ReadWrite.All |
| Créer une entrée de congé | Écriture | Crée une entrée de congé pour un utilisateur dans un planning Teams. | Schedule.ReadWrite.All |
| Créer un motif de congé | Écriture | Crée un motif de congé (par exemple, vacances, congé maladie) pour un planning Teams. | Schedule.ReadWrite.All |
| Obtenir la programmation | Lecture seule | Lit les paramètres de planification et l'état de provisionnement de l'application Shifts d'une équipe. | Schedule.Read.All |
| Lister les membres d'une chaîne | Lecture seule | Répertorie les membres d'un canal Teams et leurs rôles. | ChannelMember.Read.All |
| Lister les messages d'un canal | Lecture seule | Liste les messages d'un canal Teams. | ChannelMessage.Read.AllGroup.ReadBasic.All |
| Répertorier les canaux | Lecture seule | Répertorie les canaux d'une équipe Microsoft Teams. | Channel.ReadBasic.AllGroup.ReadBasic.All |
| Lister les messages de chat | Lecture seule | Liste les messages d'un chat Teams. | Chat.Read |
| Lister les discussions | Lecture seule | Répertorie les discussions Teams auxquelles l'utilisateur participe. | Chat.ReadBasic |
| Lister les équipes rejointes | Lecture seule | Répertorie les équipes Microsoft dont l'utilisateur est membre. | Team.ReadBasic.All |
| Lister les réponses aux messages d'un canal | Lecture seule | Lit un fil de discussion d'un canal Teams : son premier post et les réponses qui s'y trouvent. | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| Lister les groupes de planification | Lecture seule | Répertorie les groupes de planification dans le planning Shifts d'une équipe. | Schedule.Read.All |
| Lister les entrées de congés | Lecture seule | Répertorie les congés réservés dans le planning Shifts d'une équipe. | Schedule.Read.All |
| Lister les motifs de congé | Lecture seule | Répertorie les motifs de congé sélectionnables dans le planning Shifts d'une équipe. | Schedule.Read.All |
| Répondre à un message sur un canal | Écriture | Répondre à un message dans un canal Teams. | ChannelMessage.Send |
| Rechercher des messages de chat | Lecture seule | Recherche dans les messages de chat et de canal Teams auxquels l'utilisateur a accès. | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| Envoyer un message dans un canal | Écriture | Publie un message dans un canal Teams. | ChannelMessage.Send |
| Envoyer un message de chat | Écriture | Envoie un message dans un chat Teams. | ChatMessage.Send |
| Canal de mise à jour | Écriture | Met à jour le nom ou la description d'un canal Teams. | ChannelSettings.ReadWrite.All |
| Message de mise à jour de chaîne | Écriture | Modifie un message de canal précédemment publié. | ChannelMessage.ReadWrite |
| Mettre à jour le chat | Écriture | Met à jour le sujet d'un chat de groupe Teams. | Chat.ReadWrite |
| Mettre à jour le message de chat | Écriture | Modifie un message de chat précédemment envoyé. | Chat.ReadWrite |
| Mettre à jour le groupe de planification | Écriture | Met à jour le nom, l'état actif ou les membres d'un groupe de planification. | Schedule.ReadWrite.All |
| Mettre à jour l'équipe | Écriture | Met à jour le nom, la description ou la visibilité d'une équipe Teams. | TeamSettings.ReadWrite.All |
| Mettre à jour l'entrée de congé | Écriture | Met à jour une entrée de congé existante. | Schedule.ReadWrite.All |
Autorisations
La colonne Autorisations requises des tableaux précédents répertorie les autorisations Microsoft Graph déléguées dont chaque action a besoin. Gemini Enterprise ne demande que les autorisations pour les actions que vous activez, ainsi que les autorisations suivantes, que chaque connexion demande :
User.Read: lit le profil de l'utilisateur connecté, qui identifie le compte au nom duquel le connecteur agit.offline_access: permet au connecteur d'actualiser son jeton d'accès sans demander à l'utilisateur de se reconnecter.
Toutes les autorisations sont déléguées : le connecteur agit en tant qu'utilisateur connecté et ne peut accéder qu'aux données auxquelles cet utilisateur a déjà accès.
Avec OAuth géré par Google, les utilisateurs acceptent ces autorisations lorsqu'ils autorisent le connecteur. Certaines autorisations nécessitent l'accord d'un administrateur Microsoft Entra pour l'organisation. Avec votre propre application, vous accordez ces autorisations lors de l'enregistrement de l'application. Pour en savoir plus, consultez Configurer les autorisations de l'API Microsoft.
Limites
Cette section décrit les problèmes connus et les limites susceptibles d'affecter votre utilisation du data store Microsoft 365.
- Lorsque vous créez une application ou ajoutez un data store à une application existante, nous vous recommandons de n'associer qu'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 datastores Microsoft 365 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 365 n'est compatible qu'avec les emplacements
global,useteu.
Le data store Microsoft 365 est mappé de manière univoque à un seul locataire Microsoft 365. Il ne peut pas s'étendre sur plusieurs locataires isolés au sein d'une organisation mutualisée (MTO). Vous devez créer un data store dédié pour chaque locataire distinct.
OAuth géré parGooglen'est compatible qu'avec les locataires du cloud Microsoft commercial (y compris GCC) et n'est pas compatible avec la sortie d'adresse IP statique. Pour les locataires GCC High ou DoD, ou pour utiliser une sortie d'adresse IP statique, utilisez votre propre application Microsoft Entra.
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, et les requêtes les concernant peuvent renvoyer une erreur
MailboxNotEnabledForRESTAPI.
Étapes suivantes
Pour créer et configurer un data store avec Microsoft 365, consultez Configurer un datastore Microsoft 365.
Pour configurer l'application Microsoft Entra avec laquelle le connecteur s'authentifie, consultez Configuration de Microsoft 365.
Pour afficher et gérer les actions activées, consultez Gérer les actions.