Abrufen von Outlook-Nachrichten in einem freigegebenen oder delegierten Ordner

  • Artikel

In Outlook können Kunden E-Mail-Ordner für andere freigeben und „Lesen“-, „Erstellen“- oder „Ändern“-Zugriff auf einzelne Ordner gewähren. In Outlook kann ein Kunde auch einen anderen Benutzer delegieren, im Auftrag des Kunden zu handeln und auf bestimmte E-Mail-Ordner oder das gesamte Kundenpostfach zugreifen. Dies wird in Outlook auch als „Delegierung“ bezeichnet.

Programmgesteuert unterstützt Microsoft Graph das Abrufen von Nachrichten in E-Mail-Ordnern, die von anderen Benutzern freigegeben wurden, und das Abrufen der freigegebenen Ordner selbst. Die Unterstützung gilt auch für delegierte Ordner.

Als Beispiel hat Garth John lesezugriff auf seinen Posteingang freigegeben und erteilt. Wenn John sich bei Ihrer App anmeldet und delegierte Berechtigungen (Mail.Read.Shared oder Mail.ReadWrite.Shared) bereitstellt, greift Ihre App auf Garths Mail und Garths Posteingang zu, wie in diesem Artikel beschrieben.

Microsoft Graph-Berechtigungen

Verwenden Sie die delegierten Berechtigungen Mail.Read.Shared oder Mail.ReadWrite.Shared, um Nachrichten in einem freigegebenen oder delegierten Ordner jeweils zu lesen oder zu schreiben.

Diese beiden Berechtigungen unterstützen nicht das Abonnieren von Änderungsbenachrichtigungen für Elemente in freigegebenen oder delegierten Ordnern. Verwenden Sie zum Einrichten von Änderungsbenachrichtigungsabonnements für Nachrichten in einem freigegebenen, delegierten oder einem Postfachordner eines anderen Benutzers im Mandanten die Anwendungsberechtigung, Mail.Read.

Weitere Informationen finden Sie unter Mail-Berechtigungen.

Abrufen einer Nachricht im freigegebenen Ordner

Sie können eine bestimmte Nachricht in Garths Posteingang abrufen:

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')/messages/{id}

Nach erfolgreichem Abschluss erhalten Sie HTTP 200 OK, und die Meldung instance aus Garths Posteingang identifiziert{id}.

Abrufen aller Nachrichten im freigegebenen Ordner

So rufen Sie alle Nachrichten in Garths Posteingang ab:

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')/messages

Nach erfolgreichem Abschluss erhalten Sie HTTP 200 OK und eine Sammlung von Nachrichteninstanzen im Garth-Posteingang.

Abrufen des freigegebenen Ordners

Rufen Sie den Ordner (Posteingang) ab, den Garth für John freigegeben hat.

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')

Nach erfolgreichem Abschluss erhalten Sie HTTP 200 OK und eine mailFolder-instance, die garths Posteingangsordner darstellt.

Dieselben GET-Funktionen würden gelten, wenn Garth an John weiteren Zugriff auf Garths Posteingang delegiert hätte oder wenn Garth sein gesamtes Postfach an John delegiert hätte.

Wenn Garth seinen Posteingang weder für John freigegeben noch sein Postfach an John delegiert hat, gibt die Angabe der Benutzer-ID oder des Benutzerprinzipalnamens von Garth in diesen GET-Vorgängen einen Fehler zurück.

Nächste Schritte