Ü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) suchen, die in OneDrive und SharePoint gespeichert sind, und Aktionen darauf ausführen.

Hinweis:Bei der Verwendung der föderierten Suche oder föderierter Connectors wird Ihr Anfragestring an alle aktivierten Such-Backends von Drittanbietern gesendet. Der an ein Drittanbietersystem gesendete Anfragestring kann Teile der Daten aus Ihrer Suchanfrage und Ihrem Unterhaltungsverlauf enthalten. Das Drittanbietersystem kann die Anfrage mit Ihrer Identität verknüpfen. Sobald sich Daten im Drittanbietersystem befinden, unterliegen sie den Nutzungsbedingungen und Datenschutzrichtlinien dieses Systems und 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 Befehle in natürlicher Sprache verwenden, um die folgenden Aktionen auszuführen.

Aktion	Beschreibung
Kontakt erstellen	Erstellt einen neuen Kontakt in Microsoft Outlook.
Ereignis erstellen	Erstellt ein neues Ereignis.
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 einer vorhandenen E‑Mail-Nachricht im Entwurfsmodus einen oder mehrere Anhänge hinzu.
Nachricht erstellen	Erstellt eine neue E‑Mail-Nachricht im Entwurfsmodus im Postfach des angemeldeten Nutzers.
E-Mail 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 bearbeiten	Aktualisiert eine vorhandene E‑Mail-Nachricht im Entwurfsmodus 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, liest Arbeitsblätter, Tabellen und Zeilen aus Excel-Dateien (.xlsx), die in OneDrive oder SharePoint gespeichert sind.
Excel-Daten bearbeiten	Fügt Zeilen hinzu und aktualisiert sie, erstellt Arbeitsblätter und Tabellen und fügt Schlüsselspalten in Excel-Dateien (.xlsx) hinzu, die in OneDrive oder SharePoint gespeichert sind.
Word-Dokument erstellen	Erstellt ein neues Word-Dokument (.docx) im OneDrive des Nutzers.
Word-Dokument in PDF konvertieren	Konvertiert ein Word-Dokument (.docx), das in OneDrive oder SharePoint gespeichert ist, 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 PowerPoint-Präsentation (.pptx), die in OneDrive oder SharePoint gespeichert ist, 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 Kalendereinladung (annehmen, ablehnen oder vorläufig 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 Microsoft Outlook-Suche und ‑Aktionen erforderlich sind.

Verbindungsmodus	Berechtigung	Zweck
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. Dazu gehören alle Eigenschaften außer Text, Vorschau, Anhängen und erweiterten Eigenschaften.
	Mail.ReadBasic.All	(Anwendung) Ermöglicht dem Datenspeicher, grundlegende E‑Mail-Eigenschaften in allen Postfächern zu lesen. Dazu gehören alle Eigenschaften außer Text, Vorschau, Anhängen und erweiterten Eigenschaften.
	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, grundlegende Profileigenschaften anderer Nutzer in Ihrer Organisation zu lesen.
Aktionen	Mail.Send	(Delegiert) Ermöglicht dem Datenspeicher, E‑Mails als Nutzer 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.
Dateiproduktivität (Excel, Word, PowerPoint)	Files.Read.All	(Delegiert) Nur für Tools ausreichend, die Dateimetadaten lesen oder Dateiinhalte herunterladen: Auflisten von Excel-Arbeitsmappen, Lesen von Excel-Arbeitsmappenmetadaten 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 Excel-Arbeitsmappeninhalten (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. Arbeitsblattliste, Tabellenliste, Tabellenzeilenliste) ist die akzeptierte delegierte Berechtigung Files.ReadWrite. Files.ReadWrite.All bietet 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 für das Erstellen von Word- und PowerPoint-Dokumenten im OneDrive des Nutzers erforderlich.
	User.Read	(Delegiert) Erforderlich, um den OneDrive-Speicherort des angemeldeten Nutzers für Dateioperationen aufzulösen.
Aufgaben (Outlook-Aufgabenlisten 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 die Postfächer oder Kalender anderer Nutzer zugreifen).

Hinweis:Für die oben genannten Aktionen zur Dateiproduktivität muss der Tenant-Administrator 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-Fehler 403 accessDenied fehl. Empfohlen:Gewähren Sie Files.ReadWrite.All, das alle Produktivitätstools abdeckt. Wenn Sie nur die Word- oder PowerPoint-PDF-Konvertierung und die Auflistung/Metadaten von Excel-Arbeitsmappen benötigen (kein Zugriff auf Arbeitsblätter, Tabellen oder Zeilen), ist Files.Read.All allein ausreichend. Für die driveItem-basierten Vorgänge (Word/PowerPoint-PDF-Konvertierung, Auflisten 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 dem HTTP-Fehler 403 notAllowed fehl. Wenn User.ReadBasic.All (delegiert) fehlt, schlagen Tools zur Nutzersuche mit dem HTTP-Fehler 403 Authorization_RequestDenied fehl. Tenants, die einen Nutzerzugriff mit höheren Berechtigungen benötigen, können User.Read.All oder Directory.Read.All anstelle von User.ReadBasic.All verwenden.

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

Ratenlimits 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 Aufnahme als Verbindungsmodus verwenden.

Beschränkungen

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

• Wenn Sie eine neue App erstellen oder einem vorhandenen Datenspeicher einen Datenspeicher hinzufügen, empfiehlt es sich, nur einen Datenspeicher mit Aktionen zu 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 App mit VPC Service Controls schützen.

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

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

• Die Möglichkeit des Microsoft Outlook-Datenspeichers, bei Fehlern aufgrund überschrittener Ratenlimits Wiederholungen zu versuchen, hängt davon ab, ob ein Wert für retry-after von der Microsoft Graph API empfangen wird. Dieser Wert wird nur für den Outlook-Datenspeicher bereitgestellt. Die Standardanzahl der Wiederholungsversuche beträgt drei.

• Der Durchsatz des Microsoft Outlook-Datenspeichers ist durch die Einschränkungen für API-Aufrufe begrenzt, die von Microsoft Graph auferlegt werden. Die Limits gelten für jede Kombination aus App-ID und Postfach, d. h. für eine bestimmte App, die auf das Postfach eines bestimmten Nutzers oder einer bestimmten Gruppe 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 ist eins zu eins einer einzelnen Azure-Tenant-ID zugeordnet. Er kann nicht mehrere isolierte Microsoft 365-Tenants innerhalb einer Multi-Tenant-Organisation (MTO) umfassen. Sie müssen für jeden einzelnen Tenant einen eigenen Datenspeicher erstellen.

• Postfächer müssen vollständig zu Exchange Online migriert werden. Auf Postfächer, die lokal in einer Hybrid Exchange-Umgebung gehostet werden, kann nicht über die Microsoft Graph API zugegriffen werden. Versuche, diese oder tenantü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.