Descripción general

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.All
User.ReadBasic.All
Enumera los propietarios de los grupos Solo lectura Enumera los propietarios de un grupo en el directorio. GroupMember.Read.All
User.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.All
Files.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.All
Files.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.ReadWrite
Calendars.ReadWrite
Crear calendario Escritura Crea un calendario nuevo en el buzón de correo del usuario. Calendars.ReadWrite
Calendars.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.ReadWrite
Mail.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.ReadWrite
Mail.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.ReadWrite
Calendars.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.All
Group.ReadBasic.All
Mostrar canales Solo lectura Enumera los canales de un equipo de Microsoft. Channel.ReadBasic.All
Group.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.Read
ChannelMessage.Read.All
Group.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.Read
ChannelMessage.Read.All
Group.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, us y eu.

  • 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?