El conector de Microsoft 365 para Gemini Enterprise te permite buscar datos en Microsoft 365 y realizar acciones en ellos desde un solo conector: sitios de SharePoint, archivos de OneDrive, correos de Outlook, calendarios de Outlook, contactos y Microsoft Teams. El conector llega a todas estas plataformas a través de la API de Microsoft Graph.
Como un conector abarca todas las plataformas de Microsoft 365, no es necesario crear un almacén de datos independiente para SharePoint, OneDrive, Outlook y Teams.
El conector admite dos métodos de autenticación de OAuth 2.0:
- OAuth administrado porGoogle(predeterminado): El conector usa una aplicación de Microsoft Entra que administra Google . No registras tu propia aplicación ni proporcionas un ID de cliente ni secreto del cliente.
- Usa tu propia app: Registra tu propia aplicación de Microsoft Entra y proporciona su ID de usuario, ID de cliente y secreto del cliente cuando configures el almacén de datos.
Para obtener más información, consulta Configuración de Microsoft 365.
Acciones compatibles
Cuando el conector de Microsoft 365 está habilitado, los usuarios finales pueden usar comandos de lenguaje natural en Gemini Enterprise para realizar las siguientes acciones. Las acciones se agrupan por el producto de Microsoft 365 en el que actúan, lo que coincide con la forma en que se agrupan cuando seleccionas acciones en la consola deGoogle Cloud . Para cada acción, las tablas muestran si solo lee datos o también realiza cambios, y los permisos delegados de Microsoft Graph que necesita. Para saber cómo se solicitan y otorgan los permisos, consulta Permisos.
Usuarios y grupos
| Acción | Tipo | Descripción | Permisos necesarios |
|---|---|---|---|
| Agregar miembro al grupo | Escritura | Agrega un usuario como miembro de un grupo. | GroupMember.ReadWrite.All |
| Agregar propietario del grupo | Escritura | Agrega un usuario como propietario de un grupo. | Group.ReadWrite.All |
| Crear grupo | Escritura | Crea un nuevo grupo de Microsoft 365. | Group.ReadWrite.All |
| Obtener mi perfil | Solo lectura | Recupera el perfil del usuario que accedió, incluida la dirección de correo electrónico con la que se identifica su cuenta de Microsoft. | User.Read |
| Obtén el perfil de usuario | Solo lectura | Recupera el perfil de un usuario en el directorio. | User.ReadBasic.All |
| Obtén el perfil de trabajo del usuario | Solo lectura | Recupera el cargo, el departamento, la oficina, los números de teléfono, el administrador y los subordinados directos de un usuario. | User.Read.All |
| Enumerar miembros de grupo | Solo lectura | Enumera los miembros directos de un grupo en el directorio. | Group.ReadBasic.AllUser.ReadBasic.All |
| Enumera los propietarios de los grupos | Solo lectura | Enumera los propietarios de un grupo en el directorio. | GroupMember.Read.AllUser.ReadBasic.All |
| Mostrar lista de grupos | Solo lectura | Busca grupos en el directorio por nombre y devuelve el ID de cada grupo. | Group.ReadBasic.All |
| Cómo encontrar personas en el directorio | Solo lectura | Busca personas en el directorio de la organización por nombre o dirección de correo electrónico. | User.ReadBasic.All |
| Actualizar grupo | Escritura | Actualiza el nombre, la descripción o la visibilidad de un grupo. | Group.ReadWrite.All |
SharePoint y OneDrive
| Acción | Tipo | Descripción | Permisos necesarios |
|---|---|---|---|
| Obtener rango de Excel | Solo lectura | Lee los valores de las celdas de un bloque de celdas de una hoja de cálculo, incluidas las celdas que están fuera de una tabla. | Files.Read.All |
| Obtener fila de tabla de Excel | Solo lectura | Lee una fila de una tabla en un libro de Excel, con los encabezados de columna de la tabla. | Files.Read.All |
| Obtener filas de tablas de Excel | Solo lectura | Lee las filas de datos de una tabla en un libro de Excel, con los encabezados de columna de la tabla. | Files.Read.All |
| Enumera tablas de Excel | Solo lectura | Muestra una lista de las tablas con formato de un libro de Excel y la hoja de cálculo en la que se encuentra cada una. | Files.Read.All |
| Obtén las propiedades de los libros de Excel | Solo lectura | Lee las propiedades de un archivo de libro de Excel: nombre, tamaño, URL y quién lo modificó por última vez. | Files.Read.All |
| Obtener hoja de cálculo de Excel | Solo lectura | Lee una hoja de cálculo de un libro de Excel y la extensión de los datos que contiene. | Files.Read.All |
| Mostrar una lista de hojas de cálculo de Excel | Solo lectura | Enumera las hojas de cálculo de un libro de Excel en orden de pestañas. | Files.Read.All |
| Mostrar una lista de libros de Excel | Solo lectura | Encuentra libros de Excel en sitios de OneDrive y SharePoint a los que el usuario puede acceder. | Sites.Read.AllFiles.Read.All |
| Registrar en el documento | Escritura | Verifica un documento, libera su bloqueo de edición y lo pone a disposición de otros usuarios. | Files.ReadWrite.All |
| Verifica el documento | Escritura | Verifica un documento y lo bloquea para su edición exclusiva. | Files.ReadWrite.All |
| Copiar archivo | Escritura | Copia un archivo en una ubicación nueva. | Files.ReadWrite.All |
| Copiar carpeta | Escritura | Copia una carpeta en una ubicación nueva. | Files.ReadWrite.All |
| Crear archivo | Escritura | Crea un archivo nuevo con un nombre determinado dentro de una carpeta. Nunca reemplaza un archivo existente. Para ello, usa Reemplazar contenido del archivo. | Files.ReadWrite.All |
| Crear carpeta | Escritura | Crea una carpeta nueva dentro de una existente. | Files.ReadWrite.All |
| Crear vínculo para compartir | Escritura | Crea un vínculo para compartir un archivo o una carpeta. | Files.ReadWrite.All |
| Descartar confirmación de la compra | Escritura | Cancela la confirmación de salida de un documento y descarta los cambios pendientes. | Files.ReadWrite.All |
| Obtener un archivo o una carpeta por URL | Solo lectura | Busca el archivo o la carpeta a los que apunta un vínculo de SharePoint o OneDrive para que se puedan leer o realizar acciones en ellos. | Files.Read.All |
| Descargar contenido del archivo | Solo lectura | Descarga el contenido sin procesar de un archivo almacenado en una unidad. | Files.Read.All |
| Obtener mi OneDrive | Solo lectura | Obtiene la unidad de OneDrive del usuario que accedió, de modo que los archivos se puedan guardar o enumerar en su nivel superior, y se informe su cuota de almacenamiento. | Files.Read.All |
| Mostrar el contenido de la carpeta | Solo lectura | Muestra una lista de los archivos y las carpetas que se encuentran dentro de una carpeta de una unidad. | Files.Read.All |
| Enumera los permisos de archivo | Solo lectura | Enumera los permisos de uso compartido establecidos en un archivo o una carpeta. | Files.Read.All |
| Mover el archivo | Escritura | Mueve un archivo a otra carpeta. | Files.ReadWrite.All |
| Mover carpeta | Escritura | Mueve una carpeta a otra carpeta superior. | Files.ReadWrite.All |
| Cambiar el nombre del archivo | Escritura | Cambia el nombre de un archivo. | Files.ReadWrite.All |
| Cambiar nombre de carpeta | Escritura | Cambia el nombre de una carpeta. | Files.ReadWrite.All |
| Reemplazar contenido del archivo | Escritura | Reemplaza todo el contenido de un archivo que ya existe. Para crear un archivo nuevo, usa Crear archivo. | Files.ReadWrite.All |
| Envía una invitación para compartir | Escritura | Envía una invitación para compartir un archivo o una carpeta. | Files.ReadWrite.All |
| Actualiza las propiedades de un archivo o una carpeta | Escritura | Actualiza las propiedades de un archivo o una carpeta (nombre, descripción y carpeta superior). | Files.ReadWrite.All |
| Crea una lista de SharePoint | Escritura | Crea una lista nueva en un sitio de SharePoint. | Sites.Manage.All |
| Crea un elemento de lista | Escritura | Crea un elemento nuevo en una lista de SharePoint. | Sites.ReadWrite.All |
| Crea una página de SharePoint | Escritura | Crea una página nueva en un sitio de SharePoint. | Sites.ReadWrite.All |
| Obtener elemento de la lista | Solo lectura | Recupera una sola fila de una lista de SharePoint, con sus valores de columna. | Sites.Read.All |
| Obtener contenido de la página de SharePoint | Solo lectura | Recupera el cuerpo HTML de una página de SharePoint. | Sites.Read.All |
| Enumera los elementos de la lista | Solo lectura | Lee las filas de una lista de SharePoint, con los valores de columna de cada fila. | Sites.Read.All |
| Enumerar listas de SharePoint | Solo lectura | Muestra las listas de SharePoint de un sitio, incluidos el ID y la plantilla de cada lista. | Sites.Read.All |
| Enumera las páginas de SharePoint | Solo lectura | Muestra una lista de las páginas de un sitio de SharePoint, con el título, la URL y el estado de publicación de cada página. | Sites.Read.All |
| Buscar en SharePoint y OneDrive | Solo lectura | Busca sitios, páginas, elementos de lista y archivos de OneDrive de SharePoint a los que el usuario puede acceder. | Sites.Read.AllFiles.Read.All |
| Actualiza la lista de SharePoint | Escritura | Actualiza las propiedades de una lista de SharePoint (nombre y descripción). | Sites.Manage.All |
| Actualizar elemento de lista | Escritura | Actualiza los campos de un elemento de lista de SharePoint existente. | Sites.ReadWrite.All |
| Actualiza la página de SharePoint | Escritura | Actualiza el título o el nombre de archivo de una página de SharePoint. | Sites.ReadWrite.All |
Outlook
| Acción | Tipo | Descripción | Permisos necesarios |
|---|---|---|---|
| Agregar archivo adjunto | Escritura | Agrega un archivo adjunto a un mensaje de correo electrónico o evento de calendario existente. | Mail.ReadWriteCalendars.ReadWrite |
| Crear calendario | Escritura | Crea un calendario nuevo en el buzón de correo del usuario. | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| Crear contacto | Escritura | Crea un contacto nuevo en la carpeta Contactos del usuario. | Contacts.ReadWrite |
| Crea un borrador de mensaje | Escritura | Crea un borrador de mensaje de correo electrónico en el buzón del usuario. | Mail.ReadWriteMail.ReadWrite.Shared |
| Crear evento de calendario | Escritura | Crea un evento nuevo en el calendario del usuario. | Calendars.ReadWrite |
| Crear borrador de respuesta | Escritura | Crea un borrador de respuesta para el remitente de un mensaje de correo electrónico existente. | Mail.ReadWriteMail.ReadWrite.Shared |
| Cómo encontrar horarios de reunión | Solo lectura | Sugiere horarios de reunión según la disponibilidad de los asistentes. | Calendars.Read.Shared |
| Reenviar mensaje | Escritura | Reenvía un mensaje de correo electrónico existente a los destinatarios especificados. | Mail.Send |
| Obtener archivo adjunto del mensaje de correo electrónico | Solo lectura | Recupera los bytes de un archivo adjunto de un mensaje en el buzón de correo del usuario. | Mail.Read |
| Obtén respuestas automáticas | Solo lectura | Recupera el parámetro de configuración de respuesta automática (fuera de la oficina) de Outlook del usuario. | MailboxSettings.Read |
| Obtener evento de calendario | Solo lectura | Recupera un evento del calendario de Outlook del usuario, incluidas las respuestas de los asistentes y los IDs de los archivos adjuntos. | Calendars.Read |
| Obtener archivo adjunto del evento de calendario | Solo lectura | Recupera los bytes de un archivo adjunto de un evento en el calendario del usuario. | Calendars.Read |
| Obtener mensaje de correo electrónico | Solo lectura | Recupera un solo mensaje del buzón de correo del usuario. | Mail.Read |
| Cómo obtener la disponibilidad de la agenda | Solo lectura | Recupera la disponibilidad libre/ocupada de usuarios, salas o equipos durante un período. | Calendars.Read |
| Crea una lista de eventos de calendario | Solo lectura | Enumera los eventos del calendario del usuario durante un período. | Calendars.Read |
| Enumera calendarios | Solo lectura | Muestra los calendarios en el buzón de correo del usuario. | Calendars.Read |
| Cómo enumerar las categorías de Outlook | Solo lectura | Muestra las categorías (etiquetas) de la lista de categorías de Outlook del usuario. | MailboxSettings.Read |
| Enumera los contactos | Solo lectura | Enumera o busca los contactos en la libreta de direcciones de Outlook del usuario. | Contacts.Read |
| Enumera las reglas de la bandeja de entrada | Solo lectura | Muestra una lista de las reglas de la bandeja de entrada de Outlook del usuario. | MailboxSettings.Read |
| Enumera las carpetas de correo | Solo lectura | Enumera las carpetas de correo en el buzón de correo del usuario. | Mail.ReadBasic |
| Enumera los mensajes de una carpeta | Solo lectura | Muestra los mensajes de una de las carpetas de correo del usuario, como la carpeta Recibidos o Elementos enviados. | Mail.Read |
| Cómo enumerar o buscar un buzón compartido | Solo lectura | Enumera o busca los mensajes en un buzón de correo compartido o delegado al que el usuario tiene acceso. | Mail.Read.Shared |
| Mover mensaje | Escritura | Mueve un mensaje de correo electrónico a otra carpeta de correo. | Mail.ReadWrite |
| Responder a todos los mensajes | Escritura | Responde un mensaje de correo electrónico existente, a su remitente y a todos los demás destinatarios, y mantiene la respuesta en la conversación original. | Mail.Send |
| Responder mensaje | Escritura | Responde a un mensaje de correo electrónico existente, a su remitente, y mantiene la respuesta en la conversación original. | Mail.Send |
| Confirmar asistencia al evento | Escritura | Responde a una invitación a una reunión (aceptar, aceptar de forma provisoria o rechazar). | Calendars.ReadWrite |
| Buscar en el correo electrónico | Solo lectura | Busca en el correo de Outlook del usuario por palabra clave. | Mail.Read |
| Cómo buscar correos electrónicos en una carpeta | Solo lectura | Busca los mensajes en una de las carpetas de correo del usuario, incluidas las subcarpetas, como Recibidos/Facturas, por palabra clave, remitente o asunto. | Mail.Read |
| Buscar eventos de calendario | Solo lectura | Busca los eventos de calendario de Outlook del usuario por palabra clave. | Calendars.Read |
| Enviar mensaje en borrador | Escritura | Envía un mensaje de correo electrónico de borrador existente. | Mail.Send |
| Enviar correo electrónico | Escritura | Redacta y envía un mensaje de correo electrónico nuevo. | Mail.Send |
| Actualizar calendario | Escritura | Actualiza las propiedades de un calendario existente (nombre, color o estado predeterminado). | Calendars.ReadWriteCalendars.ReadWrite.Shared |
| Actualizar contacto | Escritura | Actualiza las propiedades de un contacto existente. | Contacts.ReadWrite |
| Actualizar evento | Escritura | Actualiza las propiedades de un evento de calendario existente. | Calendars.ReadWrite |
| Actualizar mensaje | Escritura | Actualiza las propiedades de un mensaje de correo electrónico existente (p.ej., marcar como leído, cambiar marcas o importancia). | Mail.ReadWrite |
| Enumera las listas de tareas | Solo lectura | Muestra las listas de tareas de Microsoft To Do (tareas de Outlook) del usuario. | Tasks.Read |
| Enumerar tareas | Solo lectura | Enumera las tareas de una de las listas de Microsoft To Do (tareas de Outlook) del usuario. | Tasks.Read |
Equipos
| Acción | Tipo | Descripción | Permisos necesarios |
|---|---|---|---|
| Agregar miembro al canal | Escritura | Agrega un usuario a un canal privado o compartido de Teams. | ChannelMember.ReadWrite.All |
| Crear canal | Escritura | Crea un canal nuevo dentro de un equipo de Teams. | Channel.Create |
| Crear chat | Escritura | Crea un nuevo chat de Teams (individual, grupal o de reunión). | Chat.Create |
| Crear reunión | Escritura | Crea una nueva reunión en línea de Teams. | OnlineMeetings.ReadWrite |
| Crea un grupo de programación | Escritura | Crea un grupo de programación dentro de un programa de Teams. | Schedule.ReadWrite.All |
| Crea una entrada de tiempo libre | Escritura | Crea una entrada de tiempo libre para un usuario en un programa de Teams. | Schedule.ReadWrite.All |
| Crea un motivo de tiempo libre | Escritura | Crea un nuevo motivo de tiempo libre (p.ej., vacaciones, licencia por enfermedad) para un programa de Teams. | Schedule.ReadWrite.All |
| Obtener programa | Solo lectura | Lee la configuración del programa de Turnos y el estado de aprovisionamiento de un equipo. | Schedule.Read.All |
| Enumera los miembros del canal | Solo lectura | Muestra una lista de los miembros de un canal de Teams y sus roles. | ChannelMember.Read.All |
| Enumera los mensajes del canal | Solo lectura | Enumera los mensajes de un canal de Teams. | ChannelMessage.Read.AllGroup.ReadBasic.All |
| Mostrar canales | Solo lectura | Enumera los canales de un equipo de Microsoft. | Channel.ReadBasic.AllGroup.ReadBasic.All |
| Enumera los mensajes de chat | Solo lectura | Enumera los mensajes de un chat de Teams. | Chat.Read |
| Enumera chats | Solo lectura | Muestra una lista de los chats de Teams de los que forma parte el usuario. | Chat.ReadBasic |
| Enumera los equipos a los que te uniste | Solo lectura | Muestra una lista de los equipos de Microsoft Teams de los que el usuario es miembro. | Team.ReadBasic.All |
| Enumera las respuestas a los mensajes del canal | Solo lectura | Lee un hilo de un canal de Teams: su primera publicación y las respuestas que se encuentran debajo. | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| Enumera los grupos de programación | Solo lectura | Enumera los grupos de programación en el programa de Turnos de un equipo. | Schedule.Read.All |
| Enumera las entradas de tiempo libre | Solo lectura | Muestra una lista de los días libres reservados en el programa de Turnos de un equipo. | Schedule.Read.All |
| Enumera los motivos de las ausencias | Solo lectura | Muestra una lista de los motivos de tiempo libre que se pueden seleccionar en el programa de Turnos de un equipo. | Schedule.Read.All |
| Responder un mensaje del canal | Escritura | Responde un mensaje en un canal de Teams. | ChannelMessage.Send |
| Cómo realizar búsquedas en los mensajes de chat | Solo lectura | Busca mensajes de canales y chats de Teams a los que el usuario puede acceder. | Chat.ReadChannelMessage.Read.AllGroup.ReadBasic.All |
| Enviar un mensaje al canal | Escritura | Publica un mensaje en un canal de Teams. | ChannelMessage.Send |
| Enviar mensaje de chat | Escritura | Envía un mensaje en un chat de Teams. | ChatMessage.Send |
| Actualización del canal | Escritura | Actualiza el nombre o la descripción de un canal de Teams. | ChannelSettings.ReadWrite.All |
| Mensaje de actualización del canal | Escritura | Edita un mensaje de canal publicado anteriormente. | ChannelMessage.ReadWrite |
| Actualizar chat | Escritura | Actualiza el tema de un chat en grupo de Teams. | Chat.ReadWrite |
| Actualizar mensaje de chat | Escritura | Edita un mensaje de chat enviado anteriormente. | Chat.ReadWrite |
| Actualiza el grupo de programación | Escritura | Actualiza el nombre, el estado activo o los miembros de un grupo de programación. | Schedule.ReadWrite.All |
| Actualizar equipo | Escritura | Actualiza el nombre, la descripción o la visibilidad de un equipo de Teams. | TeamSettings.ReadWrite.All |
| Actualiza la entrada de tiempo libre | Escritura | Actualiza una entrada de tiempo libre existente. | Schedule.ReadWrite.All |
Permisos
En la columna Permisos necesarios de las tablas anteriores, se enumeran los permisos delegados de Microsoft Graph que necesita cada acción. Gemini Enterprise solo solicita los permisos para las acciones que habilitas, además de los siguientes, que solicita cada conexión:
User.Read: Lee el perfil del usuario que accedió, que identifica la cuenta como la que actúa el conector.offline_access: Permite que el conector actualice su token de acceso sin pedirle al usuario que vuelva a acceder.
Todos los permisos se delegan: el conector actúa como el usuario que accedió y solo puede acceder a los datos a los que ese usuario ya puede acceder.
Con OAuth administrado por Google, los usuarios dan su consentimiento para estos permisos cuando autorizan el conector. Algunos permisos requieren que un administrador de Microsoft Entra dé su consentimiento para la organización. Con tu propia app, otorgas estos permisos en el registro de la app. Para obtener más información, consulta Configura los permisos de la API de Microsoft.
Limitaciones
En esta sección, se describen los problemas conocidos y las limitaciones que pueden afectar el uso del almacén de datos de Microsoft 365.
- Cuando crees una app nueva o agregues un almacén de datos a una existente, se recomienda asociar solo un almacén de datos con acciones que pertenezcan a un solo tipo de conector.
- No se admite la aplicación forzosa de un perímetro de Controles del servicio de VPC en los almacenes de datos existentes de Microsoft 365. Para aplicar de manera forzosa los Controles del servicio de VPC, debes borrar y volver a crear los almacenes de datos. Para obtener más información sobre los Controles del servicio de VPC y cómo usar acciones después de habilitarlos, consulta Protege tu app con los Controles del servicio de VPC.
- El almacén de datos de Microsoft 365 solo se admite en las ubicaciones
global,usyeu.
El almacén de datos de Microsoft 365 se asigna de forma individual a un solo usuario de Microsoft 365. No puede abarcar varios usuarios aislados dentro de una organización multiusuario (MTO). Debes crear un almacén de datos dedicado para cada usuario distinto.
OAuth administrado porGooglesolo admite usuarios en la nube comercial de Microsoft (incluido GCC) y no admite la salida de IP estática. Para los usuarios de GCC High o DoD, o para usar la salida de IP estática, usa tu propia app de Microsoft Entra.
Los buzones de correo deben migrarse por completo a Exchange Online. No se puede acceder a los buzones de correo alojados de forma local en un entorno híbrido de Exchange a través de la API de Microsoft Graph, y las consultas que se realicen en ellos pueden devolver un error
MailboxNotEnabledForRESTAPI.
¿Qué sigue?
Para crear y configurar un almacén de datos con Microsoft 365, consulta Configura un almacén de datos de Microsoft 365.
Para configurar la aplicación de Microsoft Entra con la que se autentica el conector, consulta Configuración de Microsoft 365.
Para ver y administrar las acciones habilitadas, consulta Administra acciones.