Übersicht

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

Hinweis:Wenn Sie die föderierte Suche oder föderierte Connectors verwenden, 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 die 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 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 einer vorhandenen E‑Mail-Nachricht im Entwurfsmodus einen oder mehrere Anhänge hinzu.
Nachricht erstellen	Erstellt eine neue E‑Mail-Nachricht im Postfach des angemeldeten Nutzers.
E‑Mails weiterleiten	Leitet eine vorhandene E‑Mail-Nachricht an einen oder mehrere Empfänger weiter.
E‑Mails verschieben	Verschiebt eine E‑Mail 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 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) in 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-Präsentationen in PDF-Dateien 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 Kalendereinladung (annehmen, ablehnen oder vorläufig annehmen).

Hinweise:

• Es sind auch zusätzliche schreibgeschützte Aktionen verfügbar.
• Die maximale Dateigröße für das Hoch- und Herunterladen von Dateien 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 aus allen Kalendern zu lesen.
	Calendars.ReadBasic.All	(Anwendung) Ermöglicht dem Datenspeicher, Ereignisse aller Kalender zu lesen, mit Ausnahme von Eigenschaften wie Text, Anhänge 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-Attribute in allen Postfächern zu lesen. Enthält alle Eigenschaften außer „body“, „previewBody“, „attachments“ und allen erweiterten Eigenschaften.
	Mail.ReadBasic.All	(Anwendung) Ermöglicht dem Datenspeicher, grundlegende E‑Mail-Attribute in allen Postfächern zu lesen. Enthält alle Eigenschaften außer „body“, „previewBody“, „attachments“ und allen erweiterten Eigenschaften.
	User.Read	(Delegiert) Ermöglicht dem Datenspeicher, das Profil angemeldeter Nutzer zu lesen.
	User.Read.All	(Anwendung) Ermöglicht dem Datenspeicher, die vollständigen Profilattribute, Berichte und Administratoren anderer Nutzer in Ihrer Organisation zu lesen.
	User.ReadBasic.All	(Anwendung) Ermöglicht dem Datenspeicher, eine grundlegende Gruppe von 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 ausreichend für Tools, 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 Operationen mit Excel-Arbeitsmappeninhalten (siehe nächste Zeile).
	Files.ReadWrite.All	(Delegiert) Erforderlich für alle Vorgänge für Excel-Arbeitsmappeninhalte (Lesen und Schreiben), einschließlich „Arbeitsblätter abrufen“, „Tabellen abrufen“, „Zeilen abrufen“, „Zeile abrufen“, „Arbeitsblätter und Tabellen erstellen“, „Zeilen hinzufügen und aktualisieren“ und „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 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 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 Dateivorgänge aufzulösen.
Aufgaben (Outlook-Aufgabenlisten und -Aufgaben)	Tasks.Read	(Delegiert) Erforderlich für Lesevorgänge für die 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 nachschlagen (Get User, List Users und Tools, die auf die 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 erteilen. Wenn diese Berechtigungen nicht erteilt 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 Dateiproduktivitätstools abdeckt. Wenn Sie nur die PDF-Konvertierung von Word- oder PowerPoint-Dateien und die Auflistung/Metadaten von Excel-Arbeitsmappen (kein Zugriff auf Arbeitsblätter, Tabellen oder Zeilen) benötigen, reicht Files.Read.All aus. Für die auf driveItem basierenden Vorgänge (Word-/PowerPoint-PDF-Konvertierung, Auflistung von Excel-Arbeitsmappen, Lesen von Excel-Arbeitsmappenmetadaten) werden in Microsoft Graph auch Sites.Read.All oder Sites.ReadWrite.All als akzeptierte Alternativen dokumentiert (siehe driveItem-get und driveItem-get-content-format). Eine Anleitung zur Einrichtung finden Sie unter Microsoft Outlook konfigurieren und die erforderlichen Berechtigungen festlegen.

Hinweis:Wenn Tasks.Read oder Tasks.ReadWrite fehlt, schlagen Outlook-Aufgabentools mit HTTP 403 notAllowed fehl. Fehlendes User.ReadBasic.All (delegiert) führt dazu, dass Tools zur Nutzeridentifizierung mit HTTP 403 Authorization_RequestDenied fehlschlagen. Mandanten, die Nutzerzugriff mit höheren Berechtigungen benötigen, können User.Read.All oder Directory.Read.All durch User.ReadBasic.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 Ratenbeschränkungen gelten ausschließlich für den Microsoft Outlook-Datenspeicher, wenn Sie die Aufnahme 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 App erstellen oder einer vorhandenen App einen Datenspeicher hinzufügen, empfehlen wir, nur einen Datenspeicher mit Aktionen zu verknüpfen, die zu einem einzelnen Connectortyp 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 dazu, wie Sie Aktionen nach dem Aktivieren von VPC Service Controls verwenden, finden Sie unter App mit VPC Service Controls schützen.

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

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

• Ob der Microsoft Outlook-Datenspeicher bei Fehlern aufgrund von überschrittenen Ratenlimits Wiederholungsversuche durchführen kann, hängt davon ab, ob er einen retry-after-Wert von der Microsoft Graph API erhält. Dieser Wert wird nur für den Outlook-Datenspeicher bereitgestellt. Die Standardanzahl der Wiederholungsversuche ist drei.

• Der Durchsatz des Microsoft Outlook-Datenspeichers wird durch API-Aufrufbeschränkungen von Microsoft Graph begrenzt. Die Grenzwerte gelten für jede Kombination aus App-ID und Postfach – also 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 wird eins zu eins einer einzelnen Azure-Mandanten-ID zugeordnet. Sie kann nicht mehrere isolierte Microsoft 365-Mandanten in einer Organisation mit mehreren Mandanten (Multi-Tenant Organization, MTO) umfassen. Sie müssen für jeden einzelnen Mandanten einen dedizierten Datenspeicher erstellen.

• Die Postfächer müssen vollständig zu Exchange Online migriert werden. Auf lokal gehostete Postfächer in einer Hybrid Exchange-Umgebung 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.