Abrufen von Outlook-Nachrichten in einem freigegebenen oder delegierten OrdnerGet Outlook messages in a shared or delegated folder

In Outlook können Kunden E-Mail-Ordner für andere freigeben und „Lesen“-, „Erstellen“- oder „Ändern“-Zugriff auf einzelne Ordner gewähren.Outlook lets customers share mail folders with one another and provide "read", "create", "modify", or "delete" access to individual folders. 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.Outlook also allows a customer to delegate another user to act on the customer's behalf, and access specific mail folders or the customer's entire mailbox; this is also known as "delegation" in Outlook.

Programmgesteuert unterstützt Microsoft Graph das Abrufen von Nachrichten in E-Mail-Ordnern, die andere Benutzer freigegeben haben, sowie das Abrufen der freigegebenen Ordner selbst.Programmatically, Microsoft Graph supports getting messages in mail folders that have been shared by other users, as well as getting the shared folders themselves. Die Unterstützung gilt auch für Ordner, die delegiert wurden.The support also applies to folders that have been delegated.

Beispielsweise hat Garth John Lesezugriff auf den Posteingang von Garth erteilt.As an example, Garth has shared with John and given read access to Garth's Inbox. Wenn John sich in Ihrer App angemeldet und delegierte Berechtigungen (Mail.Read.Shared oder Mail.ReadWrite.Shared) bereitgestellt hat, kann Ihre App auf Garths Mail und Posteingang zugreifen, wie nachstehend beschrieben.If John has signed into your app and provided delegated permissions (Mail.Read.Shared or Mail.ReadWrite.Shared), your app will be able to access Garth's mail and Garth's Inbox as described below.

Hinweis Mithilfe der Freigabeberechtigungen (Mail.Read.Shared oder Mail.ReadWrite.Shared) können Sie Ereignisse in einem freigegebenen oder delegierten Ordner lesen oder schreiben.Note The sharing permissions (Mail.Read.Shared or Mail.ReadWrite.Shared) allow you to read or write messages in a shared or delegated folder. Das Abonnieren von Änderungsbenachrichtigungen wird für Elemente in solchen Ordnern nicht unterstützt.They do not support subscribing to change notifications on items in such folders. Verwenden Sie zum Einrichten von Änderungsbenachrichtigungsabonnements für Nachrichten in einem freigegebenen, delegierten oder einem Postfachordner eines anderen Benutzers im Mandanten die Berechtigung „Mail.Read“.To set up change notification subscriptions on messages in a shared, delegated, or any other user's mail folder in the tenant, use the application permission, Mail.Read.

Abrufen einer Nachricht im freigegebenen OrdnerGet a message in the shared folder

Sie können eine bestimmte Nachricht in Garths Posteingang abrufen:You can get a specific message in Garth's Inbox:

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

Nach erfolgreichem Abschluss erhalten Sie „HTTP 200 OK“ und die message-Instanz mit der ID {id} aus Garths Posteingang.On successful completion, you'll get HTTP 200 OK and the message instance identified by {id} from Garth's Inbox.

Abrufen aller Nachrichten im freigegebenen OrdnerGet all messages in the shared folder

So rufen Sie alle Nachrichten in Garths Posteingang ab:Get all the messages in Garth's Inbox:

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

Nach erfolgreichem Abschluss erhalten Sie „HTTP 200 OK“ und eine Sammlung der message-Instanzen in Garths Posteingang.On successful completion, you'll get HTTP 200 OK and a collection of message instances in Garth's Inbox.

Abrufen des freigegebenen OrdnersGet the shared folder

Rufen Sie den Ordner (Posteingang) ab, den Garth für John freigegeben hat.Get the folder (Inbox) that Garth has shared with John.

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

Nach erfolgreichem Abschluss erhalten Sie „HTTP 200 OK“ und eine mailFolder-Instanz, die den Ordner „Posteingang“ von Garth darstellt.On successful completion, you'll get HTTP 200 OK and a mailFolder instance that represents Garth's Inbox folder.

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.The same GET capabilities apply if Garth had delegated John further access to Garth's Inbox, or if Garth had delegated John his entire mailbox.

Wenn Garth weder seinen Posteingang für John freigegeben noch sein Postfach für John delegiert hat, wird bei der Angabe der Benutzer-ID oder des Benutzerprinzipalnamens von Garth in diesen GET-Vorgängen ein Fehler zurückgegeben.If Garth has not shared his Inbox with John, nor has he delegated his mailbox to John, specifying Garth’s user ID or user principal name in those GET operations will return an error.

Nächste SchritteNext steps

Weitere Informationen:Find out more about: