Overview

The Microsoft Outlook data store for Gemini Enterprise lets you access your Microsoft Outlook or Office 365 data and interact with mail, calendars, and contacts.

Supported Microsoft Outlook versions

The Microsoft Outlook data store supports Microsoft Graph API v1.0 with IDP integration.

Supported actions

When the Microsoft Outlook data store is enabled, end users can use natural language commands in Gemini Enterprise to perform the following actions.

Action Description
Create event Creates a new event.
Update event Updates an existing event.
Send mail Sends an email message. This includes sending email with attachments.
Create contact Creates a new contact in Microsoft Outlook.
Update contact Updates an existing contact in Microsoft Outlook.

Required permissions

The following table outlines the permissions required for Microsoft Outlook search and actions.

Connection mode Permission Purpose
Federated search Mail.Read
Calendars.Read
Contacts.Read		 (Delegated) Allows the data store to read the signed-in user's mailbox, calendar events, and contacts.
Data ingestion Calendars.Read (Application) Allows the data store to read events of all calendars.
Calendars.ReadBasic.All (Application) Allows the data store to read events of all calendars, except for properties such as body, attachments, and extensions.
Contacts.Read (Application) Allows the data store to read all contacts in all mailboxes.
Mail.Read (Application) Allows the data store to read mail in all mailboxes.
Mail.ReadBasic (Application) Allows the data store to read basic mail properties in all mailboxes. Includes all properties except body, previewBody, attachments and any extended properties.
Mail.ReadBasic.All (Application) Allows the data store to read basic mail properties in all mailboxes. Includes all properties except body, previewBody, attachments and any extended properties.
User.Read (Delegated) Allows the data store to read the profile of signed-in users.
User.Read.All (Application) Allows the data store to read the full set of profile properties, reports, and managers of other users in your organization.
User.ReadBasic.All (Application) Allows the data store to read a basic set of profile properties of other users in your organization.
Actions Mail.Send (Delegated) Allows the data store to send mail as users in the organization.
Calendars.ReadWrite (Delegated) Allows the data store to create, read, update, and delete events in user calendars.
Contacts.ReadWrite (Delegated) Allows the data store to create, read, update, and delete user contacts.

For information on how to add the permissions for Microsoft Outlook, see Configure Microsoft Outlook and set the necessary permissions.

Rate limits for data ingestion

The request volume limit is 10,000 API requests per 10-minute period. These rate limits apply exclusively to the Microsoft Outlook data store when you choose to use ingestion as the connection mode.

Limitations

This section outlines known issues and limitations that may affect your use of the Microsoft Outlook data store.

  • When creating a new application or adding a data store to an existing one, we recommend adding only one data store with actions belonging to a single connector type, regardless of the connection mode. For example, don't associate two Microsoft Outlook data stores with enabled actions to the same application.
  • Enforcing a VPC Service Controls perimeter on existing Microsoft Outlook data stores is not supported. To enforce VPC Service Controls, you must delete and recreate the data stores. For more information on VPC Service Controls and how to use actions after enabling VPC Service Controls, see Secure your app with VPC Service Controls.
  • The Microsoft Outlook data store is supported only in Global, US, and EU locations.

  • The Microsoft Outlook data store can process one transaction per second, per node, and throttles any transactions beyond this limit.

  • The Microsoft Outlook data store's ability to retry on rate-limit exceeded errors depends on receiving a retry-after value from the Microsoft Graph API, which is only provided for the Outlook data store. The default number of retry attempts is three.

  • The Microsoft Outlook data store's throughput is limited by API call restrictions imposed by Microsoft Graph. Limits apply to each app ID and mailbox combination—that is, a specific app accessing a specific user or group mailbox. Exceeding the limit for one mailbox doesn't affect the ability of the application to access another mailbox.

What's next