Descripción general

El almacén de datos de Microsoft Outlook para Gemini Enterprise te permite buscar y realizar acciones en tus correos electrónicos, calendarios, contactos y archivos de Microsoft 365 (libros de Excel, documentos de Word y presentaciones de PowerPoint) almacenados en OneDrive y SharePoint.

Nota: Cuando usas la búsqueda federada o los conectores federados, la cadena de consulta se envía a todos los backends de búsqueda de terceros habilitados. La cadena de consulta enviada a un sistema de terceros puede contener partes de los datos de tu solicitud de búsqueda y del historial de conversaciones. El sistema de terceros puede vincular la consulta con tu identidad. Una vez que los datos se encuentran en el sistema de terceros, están sujetos a las Condiciones del Servicio y las políticas de privacidad de ese sistema, no a las Condiciones del Servicio de Google Cloud.

Versiones compatibles de Microsoft Outlook

El almacén de datos de Microsoft Outlook admite la API de Microsoft Graph v1.0 con integración de IDP.

Acciones compatibles

Cuando el almacén de datos de Microsoft Outlook está habilitado, los usuarios finales pueden usar comandos de lenguaje natural en Gemini Enterprise para realizar las siguientes acciones.

Acción	Descripción
Crear contacto	Crea un contacto nuevo en Microsoft Outlook.
Crear evento	Crea un evento nuevo.
Descargar archivos adjuntos	Descarga un archivo adjunto de un mensaje de correo electrónico de Microsoft Outlook.
Enviar correo electrónico	Envía un mensaje de correo electrónico. Esto incluye enviar correos electrónicos con archivos adjuntos.
Agregar adjuntos	Agrega uno o más archivos adjuntos a un borrador de mensaje de correo electrónico existente.
Crear mensaje	Crea un nuevo mensaje de correo electrónico en borrador en el buzón del usuario que accedió.
Reenviar correo electrónico	Reenvía un mensaje de correo electrónico existente a uno o más destinatarios.
Mover correo electrónico	Mueve un mensaje de correo electrónico a otra carpeta de correo en el buzón del usuario que accedió.
Responder mensaje	Envía una respuesta a un mensaje de correo electrónico existente en el buzón del usuario que accedió.
Actualizar mensaje	Actualiza un borrador de mensaje de correo electrónico existente en el buzón del usuario que accedió.
Actualizar contacto	Actualiza un contacto existente en Microsoft Outlook.
Actualizar evento	Actualiza un evento existente.
Leer datos de Excel	Enumera libros, lee hojas de cálculo, tablas y filas de archivos de Excel (.xlsx) almacenados en OneDrive o SharePoint.
Editar datos de Excel	Agrega y actualiza filas, crea hojas de cálculo y tablas, y agrega columnas clave en archivos de Excel (.xlsx) almacenados en OneDrive o SharePoint.
Crea un documento de Word	Crea un documento de Word (.docx) nuevo en la cuenta de OneDrive del usuario.
Convertir un documento de Word en PDF	Convierte un documento de Word (.docx) almacenado en OneDrive o SharePoint a PDF.
Crear presentación de PowerPoint	Crea una nueva presentación de PowerPoint (.pptx) en el OneDrive del usuario.
Cómo convertir archivos de PowerPoint a PDF	Convierte una presentación de PowerPoint (.pptx) almacenada en OneDrive o SharePoint a PDF.
Crear calendario	Crea un calendario nuevo para el usuario que accedió.
Actualizar calendario	Actualiza un calendario existente para el usuario que accedió.
Confirmar asistencia al evento	Responde (acepta, rechaza o acepta de forma provisoria) a una invitación a un evento de calendario.

Notas:

• También hay disponibles acciones adicionales de solo lectura.
• El tamaño máximo de los archivos que se suben y descargan en Gemini Enterprise es de 25 MB.
• Las acciones de Excel, Word y PowerPoint requieren permisos adicionales de la API de Microsoft Graph en los archivos de OneDrive o SharePoint con los que trabaja el usuario. Para obtener más información, consulta [Permisos necesarios](#required-permissions).

Permisos necesarios

En la siguiente tabla, se describen los permisos necesarios para realizar búsquedas y acciones en Microsoft Outlook.

Modo de conexión	Permiso	Purpose
Búsqueda federada	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	(Delegado) Permite que el almacén de datos lea el buzón de correo del usuario que accedió, los correos electrónicos de los buzones de correo compartidos, los eventos de calendario y los contactos.
Ingesta de datos	Calendars.Read	(Aplicación) Permite que el almacén de datos lea eventos de todos los calendarios.
	Calendars.ReadBasic.All	(Aplicación) Permite que el almacén de datos lea los eventos de todos los calendarios, excepto las propiedades como el cuerpo, los archivos adjuntos y las extensiones.
	Contacts.Read	(Aplicación) Permite que el almacén de datos lea todos los contactos de todos los buzones de correo.
	Mail.Read	(Aplicación) Permite que el almacén de datos lea el correo en todos los buzones.
	Mail.ReadBasic	(Aplicación) Permite que el almacén de datos lea las propiedades básicas de los correos electrónicos en todos los buzones de correo. Incluye todas las propiedades, excepto body, previewBody, attachments y cualquier propiedad extendida.
	Mail.ReadBasic.All	(Aplicación) Permite que el almacén de datos lea las propiedades básicas de los correos electrónicos en todos los buzones de correo. Incluye todas las propiedades, excepto body, previewBody, attachments y cualquier propiedad extendida.
	User.Read	(Delegado) Permite que el almacén de datos lea el perfil de los usuarios que accedieron.
	User.Read.All	(Aplicación) Permite que el almacén de datos lea el conjunto completo de propiedades de perfil, informes y administradores de otros usuarios de tu organización.
	User.ReadBasic.All	(Aplicación) Permite que el almacén de datos lea un conjunto básico de propiedades de perfil de otros usuarios de tu organización.
Actions	Mail.Send	(Delegado) Permite que el almacén de datos envíe correos electrónicos como usuarios de la organización.
	Mail.ReadWrite	(Delegado) Permite que el almacén de datos cree, lea, actualice, mueva y borre mensajes, y que agregue archivos adjuntos a los mensajes. Obligatorio para las acciones **Agregar archivos adjuntos**, **Crear mensaje**, **Actualizar mensaje** y **Mover correo electrónico**.
	Calendars.ReadWrite	(Delegado) Permite que el almacén de datos cree, lea, actualice y borre eventos en los calendarios de los usuarios.
	Contacts.ReadWrite	(Delegado) Permite que el almacén de datos cree, lea, actualice y borre los contactos del usuario.
	User.Read	(Delegado) Permite que el almacén de datos lea el perfil de los usuarios que accedieron.
Productividad de archivos (Excel, Word, PowerPoint)	Files.Read.All	(Delegado) Es suficiente solo para las herramientas que leen metadatos de archivos o descargan contenido de archivos: enumerar libros de Excel, leer metadatos de libros de Excel y convertir documentos de Word (.docx) o PowerPoint (.pptx) a PDF. Lee todos los archivos a los que el usuario puede acceder, incluidos los archivos almacenados en los sitios de SharePoint a los que el usuario tiene acceso. No es suficiente para las operaciones de contenido de libros de Excel (consulta la siguiente fila).
	Files.ReadWrite.All	(Delegado) Es obligatorio para todas las operaciones de contenido de los libros de Excel (lectura y escritura), incluidas las de obtener hojas de cálculo, obtener tablas, obtener filas, obtener una fila, crear hojas de cálculo y tablas, agregar y actualizar filas, y agregar columnas clave. Según la referencia de la API de Microsoft Graph para estos extremos (por ejemplo, worksheet-list, table-list y tablerow-list), el permiso delegado aceptado es Files.ReadWrite. Files.ReadWrite.All otorga la misma capacidad en todas las unidades a las que el usuario puede acceder (OneDrive personal y cualquier biblioteca de documentos de SharePoint a la que el usuario tenga acceso). También se requiere para crear documentos de Word y PowerPoint en el OneDrive del usuario.
	User.Read	(Delegado) Es obligatorio para resolver la ubicación de OneDrive del usuario que accedió para las operaciones de archivo.
Tareas (listas de tareas pendientes y tareas de Outlook)	Tasks.Read	(Delegado) Es obligatorio para las operaciones de lectura en las listas de tareas y las tareas de Outlook del usuario que accedió (enumerar listas de tareas, enumerar tareas, obtener tarea).
	Tasks.ReadWrite	(Delegado) Es obligatorio para las operaciones de escritura: crear, actualizar y borrar tareas en las listas de tareas de Outlook del usuario que accedió.
Usuarios y directorio (enumeración delegada)	User.ReadBasic.All	(Delegado) Es obligatorio para las herramientas que enumeran o buscan perfiles de otros usuarios de la organización (Obtener usuario, Enumerar usuarios y herramientas que operan en los buzones de correo o calendarios de otros usuarios).

Nota: Las acciones de productividad de archivos anteriores requieren que el administrador de usuarios del usuario otorgue los permisos correspondientes de la API de Microsoft Graph en el registro de la app de OAuth. Si no se otorgan estos permisos, las solicitudes a las herramientas de Excel, Word y PowerPoint fallarán con un error HTTP 403 accessDenied. Recomendado: Otorga Files.ReadWrite.All, que abarca todas las herramientas de productividad de archivos. Si solo necesitas la conversión de PDF de Word o PowerPoint y la lista o los metadatos de los libros de Excel (sin acceso a hojas de cálculo, tablas ni filas), basta con Files.Read.All. Para las operaciones basadas en driveItem (conversión de Word/PowerPoint a PDF, enumeración de libros de Excel, lectura de metadatos de libros de Excel), Microsoft Graph también documenta Sites.Read.All o Sites.ReadWrite.All como alternativas aceptadas (consulta driveItem-get y driveItem-get-content-format). Consulta Configura Microsoft Outlook y establece los permisos necesarios para conocer los pasos de configuración.

Nota: Si falta Tasks.Read o Tasks.ReadWrite, las herramientas de tareas de Outlook fallarán con el error HTTP 403 notAllowed. La falta de User.ReadBasic.All (delegado) hace que las herramientas de búsqueda de usuarios fallen con el error HTTP 403 Authorization_RequestDenied. Los usuarios que necesiten acceso con privilegios más altos pueden sustituir User.Read.All o Directory.Read.All por User.ReadBasic.All.

Para obtener información sobre cómo agregar los permisos para Microsoft Outlook, consulta Configura Microsoft Outlook y establece los permisos necesarios.

Límites de frecuencia para la transferencia de datos

El límite de volumen de solicitudes es de 10,000 solicitudes a la API por período de 10 minutos. Estos límites de frecuencia se aplican exclusivamente al almacén de datos de Microsoft Outlook cuando eliges usar la transferencia como el modo de conexión.

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 Outlook.

• Cuando crees una app nueva o agregues un almacén de datos a una existente, te recomendamos que asocies solo un almacén de datos con acciones que pertenezcan a un solo tipo de conector.

• No se admite la aplicación de un perímetro de Controles del servicio de VPC en los almacenes de datos existentes de Microsoft Outlook. Para aplicar 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 Outlook solo se admite en las ubicaciones global, us y eu.

• El almacén de datos de Microsoft Outlook puede procesar una transacción por segundo, por nodo, y limita las transacciones que superen este límite.

• La capacidad del almacén de datos de Microsoft Outlook para reintentar cuando se supera el límite de frecuencia depende de que se reciba un valor retry-after de la API de Microsoft Graph, que solo se proporciona para el almacén de datos de Outlook. La cantidad predeterminada de intentos de reintento es tres.

• La capacidad de procesamiento del almacén de datos de Microsoft Outlook está limitada por las restricciones de llamadas a la API que impone Microsoft Graph. Los límites se aplican a cada combinación de ID de app y buzón de correo, es decir, una app específica que accede al buzón de correo de un usuario o grupo específico. Superar el límite de un buzón de correo no afecta la capacidad de la aplicación para acceder a otro buzón de correo.

• El almacén de datos de Microsoft Outlook se asigna de forma unívoca a un solo ID de usuario de Azure. No puede abarcar varios usuarios aislados de Microsoft 365 dentro de una organización multiusuario (MTO). Debes crear un almacén de datos dedicado para cada usuario distinto.

• 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 de Exchange híbrido a través de la API de Microsoft Graph. Los intentos de consultar estos buzones de correo o los de varios usuarios pueden generar un error MailboxNotEnabledForRESTAPI.

• El almacén de datos de Microsoft Outlook puede procesar una transacción por segundo por nodo y limita las transacciones que superen este límite.

¿Qué sigue?

• Para crear y configurar un almacén de datos con Microsoft Outlook, consulta Configura un almacén de datos de Microsoft Outlook.