Übersicht

Mit dem Microsoft Outlook-Datenspeicher für Gemini Enterprise können Sie in Ihren E‑Mails, Kalendern, Kontakten und Microsoft 365-Dateien (Excel-Arbeitsmappen, Word-Dokumente und PowerPoint-Präsentationen), die in OneDrive und SharePoint gespeichert sind, suchen und Aktionen ausführen.

Hinweis: Wenn Sie die föderierte Suche oder föderierte Connectors verwenden, wird Ihr Abfragestring an alle aktivierten Such-Backends von Drittanbietern gesendet. Der an ein Drittanbietersystem gesendete Abfragestring kann Teile der Daten aus Ihrer Suchanfrage und Ihrem Unterhaltungsverlauf enthalten. Das Drittanbietersystem kann die Abfrage mit Ihrer Identität verknüpfen. Sobald sich die Daten im Drittanbietersystem befinden, unterliegen sie den Nutzungsbedingungen und Datenschutzrichtlinien dieses Systems, nicht den Nutzungsbedingungen von Google Cloud.

Unterstützte Microsoft Outlook-Versionen

Der Microsoft Outlook-Datenspeicher unterstützt die Microsoft Graph API v1.0 mit IDP-Integration.

Unterstützte Aktionen

Wenn der Microsoft Outlook-Datenspeicher aktiviert ist, können Endnutzer in Gemini Enterprise mit Befehlen in natürlicher Sprache die folgenden Aktionen ausführen.

Aktion	Beschreibung
Kontakt erstellen	Erstellt einen neuen Kontakt in Microsoft Outlook.
Ereignis erstellen	Erstellt einen neuen Termin.
Anhänge herunterladen	Lädt einen Anhang aus einer Microsoft Outlook-E‑Mail-Nachricht herunter.
E-Mail senden	Sendet eine E‑Mail-Nachricht. Dazu gehört auch das Senden von E‑Mails mit Anhängen.
Anhänge hinzufügen	Fügt einem vorhandenen E‑Mail-Entwurf einen oder mehrere Anhänge hinzu.
Nachricht erstellen	Erstellt einen neuen E‑Mail-Entwurf im Postfach des angemeldeten Nutzers.
E‑Mails weiterleiten	Leitet eine vorhandene E‑Mail-Nachricht an einen oder mehrere Empfänger weiter.
E‑Mail verschieben	Verschiebt eine E‑Mail-Nachricht in einen anderen E‑Mail-Ordner im Postfach des angemeldeten Nutzers.
Nachricht beantworten	Sendet eine Antwort auf eine vorhandene E‑Mail-Nachricht im Postfach des angemeldeten Nutzers.
Nachricht aktualisieren	Aktualisiert einen vorhandenen E‑Mail-Entwurf im Postfach des angemeldeten Nutzers.
Kontakt aktualisieren	Aktualisiert einen vorhandenen Kontakt in Microsoft Outlook.
Termin aktualisieren	Aktualisiert einen vorhandenen Termin.
Excel-Daten lesen	Listet Arbeitsmappen auf und liest Arbeitsblätter, Tabellen und Zeilen aus Excel-Dateien (.xlsx), die in OneDrive oder SharePoint gespeichert sind.
Excel-Daten bearbeiten	Fügt Zeilen in Excel-Dateien (.xlsx) hinzu, die in OneDrive oder SharePoint gespeichert sind, aktualisiert sie, erstellt Arbeitsblätter und Tabellen und fügt Schlüsselspalten hinzu.
Word-Dokument erstellen	Erstellt ein neues Word-Dokument (.docx) im OneDrive des Nutzers.
Word-Dokument in PDF konvertieren	Konvertiert ein in OneDrive oder SharePoint gespeichertes Word-Dokument (.docx) in eine PDF-Datei.
PowerPoint-Präsentation erstellen	Erstellt eine neue PowerPoint-Präsentation (.pptx) im OneDrive des Nutzers.
PowerPoint in PDF konvertieren	Konvertiert eine in OneDrive oder SharePoint gespeicherte PowerPoint-Präsentation (.pptx) in eine PDF-Datei.
Kalender erstellen	Erstellt einen neuen Kalender für den angemeldeten Nutzer.
Kalender aktualisieren	Aktualisiert einen vorhandenen Kalender für den angemeldeten Nutzer.
Um Antwort wird gebeten	Antwortet auf eine Einladung zu einem Kalendertermin (Annehmen, Ablehnen oder Vorbehaltlich annehmen).

Hinweise:

• Es sind auch zusätzliche Aktionen mit Lesezugriff verfügbar.
• Die maximale Dateigröße für Datei-Uploads und -Downloads in Gemini Enterprise beträgt 25 MB.
• Für Excel-, Word- und PowerPoint-Aktionen sind zusätzliche Microsoft Graph API-Berechtigungen für die OneDrive- oder SharePoint-Dateien erforderlich, mit denen der Nutzer arbeitet. Weitere Informationen finden Sie unter [Erforderliche Berechtigungen](#required-permissions).

Erforderliche Berechtigungen

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Suche und Aktionen in Microsoft Outlook erforderlich sind.

Verbindungsmodus	Berechtigung	Purpose
Föderierte Suche	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	(Delegiert) Ermöglicht dem Datenspeicher, das Postfach des angemeldeten Nutzers, E‑Mails aus freigegebenen Postfächern, Kalendertermine und Kontakte zu lesen.
Datenaufnahme	Calendars.Read	(Anwendung) Ermöglicht dem Datenspeicher, Termine aller Kalender zu lesen.
	Calendars.ReadBasic.All	(Anwendung) Ermöglicht dem Datenspeicher, Termine aller Kalender zu lesen, mit Ausnahme von Eigenschaften wie Text, Anhängen und Erweiterungen.
	Contacts.Read	(Anwendung) Ermöglicht dem Datenspeicher, alle Kontakte in allen Postfächern zu lesen.
	Mail.Read	(Anwendung) Ermöglicht dem Datenspeicher, E‑Mails in allen Postfächern zu lesen.
	Mail.ReadBasic	(Anwendung) Ermöglicht dem Datenspeicher, grundlegende E‑Mail-Eigenschaften in allen Postfächern zu lesen. Enthält alle Properties außer „body“, „previewBody“, „attachments“ und alle erweiterten Properties.
	Mail.ReadBasic.All	(Anwendung) Ermöglicht dem Datenspeicher, grundlegende E‑Mail-Eigenschaften in allen Postfächern zu lesen. Enthält alle Properties außer „body“, „previewBody“, „attachments“ und alle erweiterten Properties.
	User.Read	(Delegiert) Ermöglicht dem Datenspeicher, das Profil angemeldeter Nutzer zu lesen.
	User.Read.All	(Anwendung) Ermöglicht dem Datenspeicher, alle Profileigenschaften, Berichte und Manager anderer Nutzer in Ihrer Organisation zu lesen.
	User.ReadBasic.All	(Anwendung) Ermöglicht dem Datenspeicher, einen grundlegenden Satz von Profileigenschaften anderer Nutzer in Ihrer Organisation zu lesen.
Aktionen	Mail.Send	(Delegiert) Ermöglicht dem Datenspeicher, E‑Mails im Namen von Nutzern in der Organisation zu senden.
	Mail.ReadWrite	(Delegiert) Ermöglicht dem Datenspeicher, Nachrichten zu erstellen, zu lesen, zu aktualisieren, zu verschieben und zu löschen sowie Anhänge zu Nachrichten hinzuzufügen. Erforderlich für die Aktionen **Anhänge hinzufügen**, **Nachricht erstellen**, **Nachricht aktualisieren** und **E‑Mail verschieben**.
	Calendars.ReadWrite	(Delegiert) Ermöglicht dem Datenspeicher, Termine in Nutzerkalendern zu erstellen, zu lesen, zu aktualisieren und zu löschen.
	Contacts.ReadWrite	(Delegiert) Ermöglicht dem Datenspeicher, Nutzerkontakte zu erstellen, zu lesen, zu aktualisieren und zu löschen.
	User.Read	(Delegiert) Ermöglicht dem Datenspeicher, das Profil angemeldeter Nutzer zu lesen.
Produktivität (Excel, Word, PowerPoint)	Files.Read.All	(Delegiert) Nur ausreichend für Tools, die Dateimetadaten lesen oder Dateiinhalte herunterladen: Auflisten von Excel-Arbeitsmappen, Lesen von Metadaten von Excel-Arbeitsmappen und Konvertieren von Word- (.docx) oder PowerPoint-Dokumenten (.pptx) in PDF. Liest alle Dateien, auf die der Nutzer zugreifen kann, einschließlich Dateien, die auf SharePoint-Websites gespeichert sind, auf die der Nutzer Zugriff hat. Nicht ausreichend für Vorgänge mit Inhalten von Excel-Arbeitsmappen (siehe nächste Zeile).
	Files.ReadWrite.All	(Delegiert) Erforderlich für alle Vorgänge mit Excel-Arbeitsmappeninhalten (Lesen und Schreiben), einschließlich Arbeitsblätter abrufen, Tabellen abrufen, Zeilen abrufen, Zeile abrufen, Arbeitsblätter und Tabellen erstellen, Zeilen hinzufügen und aktualisieren sowie Schlüsselspalten hinzufügen. Gemäß der Microsoft Graph API-Referenz für diese Endpunkte (z. B. worksheet-list, table-list, tablerow-list) ist die akzeptierte delegierte Berechtigung Files.ReadWrite. Files.ReadWrite.All gewährt dieselbe Funktion für alle Laufwerke, auf die der Nutzer zugreifen kann (persönliches OneDrive und alle SharePoint-Dokumentbibliotheken, auf die der Nutzer Zugriff hat). Auch erforderlich, um Word- und PowerPoint-Dokumente im OneDrive des Nutzers zu erstellen.
	User.Read	(Delegiert) Erforderlich, um den OneDrive-Speicherort des angemeldeten Nutzers für Dateioperationen aufzulösen.
Aufgaben (Outlook-To-do-Listen und -Aufgaben)	Tasks.Read	(Delegiert) Erforderlich für Lesevorgänge in den Outlook-Aufgabenlisten und ‑Aufgaben des angemeldeten Nutzers (Aufgabenlisten auflisten, Aufgaben auflisten, Aufgabe abrufen).
	Tasks.ReadWrite	(Delegiert) Erforderlich für Schreibvorgänge: Erstellen, Aktualisieren und Löschen von Aufgaben in den Outlook-Aufgabenlisten des angemeldeten Nutzers.
Nutzer und Verzeichnis (delegierte Aufzählung)	User.ReadBasic.All	(Delegiert) Erforderlich für Tools, die Profile anderer Nutzer in der Organisation auflisten oder suchen (Nutzer abrufen, Nutzer auflisten und Tools, die auf Postfächer oder Kalender anderer Nutzer zugreifen).

Hinweis: Für die oben genannten Aktionen zur Dateiproduktivität muss der Mandantenadministrator des Nutzers die entsprechenden Microsoft Graph API-Berechtigungen für die OAuth-App-Registrierung gewähren. Wenn diese Berechtigungen nicht gewährt werden, schlagen Anfragen an Excel-, Word- und PowerPoint-Tools mit dem HTTP-403-Fehler accessDenied fehl. Empfohlen: Gewähren Sie Files.ReadWrite.All, was alle Produktivitätstools für Dateien abdeckt. Wenn Sie nur die PDF-Konvertierung von Word oder PowerPoint und die Auflistung/Metadaten von Excel-Arbeitsmappen benötigen (kein Zugriff auf Arbeitsblätter, Tabellen oder Zeilen), reicht Files.Read.All allein aus. Für die driveItem-basierten Vorgänge (Word/PowerPoint-PDF-Konvertierung, Auflistung von Excel-Arbeitsmappen, Lesen von Excel-Arbeitsmappenmetadaten) dokumentiert Microsoft Graph auch Sites.Read.All oder Sites.ReadWrite.All als akzeptierte Alternativen (siehe driveItem-get und driveItem-get-content-format). Die Einrichtungsschritte finden Sie unter Microsoft Outlook konfigurieren und die erforderlichen Berechtigungen festlegen.

Hinweis: Wenn Tasks.Read oder Tasks.ReadWrite fehlen, schlagen Outlook-Aufgabentools mit HTTP 403 notAllowed fehl. Wenn User.ReadBasic.All (delegiert) fehlt, schlagen Tools für die Nutzersuche mit HTTP 403 Authorization_RequestDenied fehl. Mandanten, die Nutzerzugriff mit höheren Berechtigungen benötigen, können User.ReadBasic.All durch User.Read.All oder Directory.Read.All ersetzen.

Informationen zum Hinzufügen der Berechtigungen für Microsoft Outlook finden Sie unter Microsoft Outlook konfigurieren und die erforderlichen Berechtigungen festlegen.

Ratenbegrenzungen für die Datenaufnahme

Das Limit für das Anfragevolumen beträgt 10.000 API-Anfragen pro 10-Minuten-Zeitraum. Diese Ratenbegrenzungen gelten ausschließlich für den Microsoft Outlook-Datenspeicher, wenn Sie die Datenaufnahme als Verbindungsmodus auswählen.

Beschränkungen

In diesem Abschnitt werden bekannte Probleme und Einschränkungen beschrieben, die sich auf die Verwendung des Microsoft Outlook-Datenspeichers auswirken können.

• Wenn Sie eine neue Anwendung erstellen oder einer vorhandenen Anwendung einen Datenspeicher hinzufügen, sollten Sie nur einen Datenspeicher mit Aktionen verknüpfen, die zu einem einzelnen Connector-Typ gehören.

• Das Erzwingen eines VPC Service Controls-Perimeters für vorhandene Microsoft Outlook-Datenspeicher wird nicht unterstützt. Wenn Sie VPC Service Controls erzwingen möchten, müssen Sie die Datenspeicher löschen und neu erstellen. Weitere Informationen zu VPC Service Controls und zur Verwendung von Aktionen nach dem Aktivieren von VPC Service Controls finden Sie unter Anwendung mit VPC Service Controls sichern.

• Der Microsoft Outlook-Datenspeicher wird nur an den Standorten global, us und eu unterstützt.

• Der Microsoft Outlook-Datenspeicher kann eine Transaktion pro Sekunde und Knoten verarbeiten. Alle Transaktionen, die dieses Limit überschreiten, werden gedrosselt.

• Die Fähigkeit des Microsoft Outlook-Datenspeichers, bei Fehlern aufgrund einer Überschreitung des Ratenlimits einen neuen Versuch zu starten, hängt davon ab, ob er von der Microsoft Graph API einen retry-after-Wert erhält. Dieser wird nur für den Outlook-Datenspeicher bereitgestellt. Die Standardanzahl der Wiederholungsversuche ist drei.

• Der Durchsatz des Microsoft Outlook-Datenspeichers ist durch API-Aufrufbeschränkungen von Microsoft Graph begrenzt. Die Limits gelten für jede Kombination aus App-ID und Postfach, d. h. für eine bestimmte App, die auf ein bestimmtes Nutzer- oder Gruppenpostfach zugreift. Wenn das Limit für ein Postfach überschritten wird, hat das keine Auswirkungen auf die Möglichkeit der Anwendung, auf ein anderes Postfach zuzugreifen.

• Der Microsoft Outlook-Datenspeicher wird eins zu eins einer einzelnen Azure-Mandanten-ID zugeordnet. Sie kann nicht mehrere isolierte Microsoft 365-Mandanten innerhalb einer Multi-Tenant Organization (MTO) umfassen. Sie müssen für jeden Mandanten einen dedizierten Datenspeicher erstellen.

• Postfächer müssen vollständig zu Exchange Online migriert sein. Auf lokal in einer Hybrid-Exchange-Umgebung gehostete Postfächer kann nicht über die Microsoft Graph API zugegriffen werden. Versuche, diese oder mandantenübergreifende Postfächer abzufragen, können zu einem MailboxNotEnabledForRESTAPI-Fehler führen.

• Der Microsoft Outlook-Datenspeicher kann eine Transaktion pro Sekunde und Knoten verarbeiten und drosselt alle Transaktionen, die dieses Limit überschreiten.

Nächste Schritte

• Informationen zum Erstellen und Konfigurieren eines Datenspeichers mit Microsoft Outlook finden Sie unter Microsoft Outlook-Datenspeicher einrichten.