Abrufen von Outlook-Nachrichten in einem freigegebenen oder delegierten Ordner
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.
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.
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}
.
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.
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.
- Gründe für die Integration in Outlook-Mail
- Verwenden der E-Mail-API und ihrer Anwendungsfälle in Microsoft Graph v1.0