Abrufen von Outlook-Ereignissen in einem freigegebenen oder delegierten KalenderGet Outlook events in a shared or delegated calendar

In Outlook können Kunden einen Kalender mit anderen Benutzern teilen und sie Ereignisse in diesem Kalender anzeigen oder ändern lassen.In Outlook, customers can share a calendar with other users and let them view or modify events in that calendar. Kunden können außerdem eine Stellvertretung für das Handeln in ihrem Auftrag erteilen, um Besprechungsanfragen zu empfangen oder zu beantworten oder um Elemente im Kalender zu erstellen oder zu ändern.Customers can also grant a delegate to act on their behalf, to receive or respond to meeting requests, or create or change items in the calendar.

Programmgesteuert unterstützt Microsoft Graph das Abrufen von Ereignissen in Kalendern, die von anderen Benutzern geteilt wurden, sowie das Abrufen der Kalender selbst.Programmatically, Microsoft Graph supports getting events in calendars that have been shared by other users, as well as getting the shared calendars themselves. Die Unterstützung gilt auch für Kalender, die delegiert wurden.The support also applies to calendars that have been delegated.

Beispielsweise hat Adrian für John seinen Standardkalender freigegeben und John Lesezugriff erteilt.As an example, Garth has shared with John his default calendar and given John read access. Wenn John sich in Ihrer App angemeldet und delegierte Berechtigungen (Calendars.Read.Shared oder Calendars.ReadWrite.Shared) bereitgestellt hat, kann Ihre App auf Adrians Standardkalender und auf die Ereignisse in diesem Kalender zugreifen, wie nachstehend beschrieben.If John has signed into your app and provided delegated permissions (Calendars.Read.Shared or Calendars.ReadWrite.Shared), your app will be able to access Garth's default calendar and events in that calendar as described below.

Hinweis Mithilfe der Freigabeberechtigungen (Calendars.Read.Shared oder Calendars.ReadWrite.Shared) können Sie Ereignisse in einem freigegebenen oder delegierten Kalender lesen oder schreiben.Note The sharing permissions (Calendars.Read.Shared or Calendars.ReadWrite.Shared) allow you to read or write events in a shared or delegated calendar. 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 Ereignisse in einem freigegebenen, delegierten oder einem anderen Benutzer- oder Ressourcenkalender im Mandanten die Berechtigung „Calendars.Read“.To set up change notification subscriptions on events in a shared, delegated, or any other user or resource calendar in the tenant, use the application permission, Calendars.Read.

Abrufen eines Ereignisses im freigegebenen KalenderGet an event in the shared calendar

Sie können ein bestimmtes Ereignis in Adrians freigegebenem Standardkalender abrufen:You can get a specific event in Garth's shared default calendar:

GET users/{Garth-userId | Garth-userPrincipalName}/calendar/events/{id}

Nach erfolgreichem Abschluss erhalten Sie "HTTP 200 OK" und die event-Instanz mit der ID {id} aus Adrians Posteingang.On successful completion, you'll get HTTP 200 OK and the event instance identified by {id} from Garth's default calendar.

Abrufen aller Ereignisse im freigegebenen KalenderGet all the events in the shared calendar

Rufen Sie alle Ereignisse im Standardkalender ab, den Adrian mit John geteilt hat:Get all the events in the default calendar that Garth has shared with John:

GET users/{Garth-userId | Garth-userPrincipalName}/calendar/events

Nach erfolgreichem Abschluss erhalten Sie "HTTP 200 OK" und eine Sammlung der event-Instanzen in Adrians Standardkalender.On successful completion, you'll get HTTP 200 OK and a collection of event instances in Garth's default calendar.

Abrufen des freigegebenen KalendersGet the shared calendar

Rufen Sie den Standardkalender ab, den Adrian mit John geteilt hat.Get the default calendar that Garth has shared with John.

GET users/{Garth-userId | Garth-userPrincipalName}/calendar

Nach erfolgreichem Abschluss erhalten Sie "HTTP 200 OK" und eine calendar-Instanz, die Adrians Standardordner darstellt.On successful completion, you'll get HTTP 200 OK and a calendar instance that represents Garth's default folder.

Dieselben GET-Funktionen würden gelten, wenn Adrian an John weiteren Zugriff auf Adrians Standardkalender delegiert hätte oder wenn Adrian sein gesamtes Postfach an John delegiert hätte.The same GET capabilities apply if Garth had delegated John further access to Garth's default calendar, or if Garth had delegated John his entire mailbox.

Wenn Adrian weder seinen Standardkalender für John freigegeben noch sein Postfach an John delegiert hat, wird bei der Angabe von Adrians Benutzer-ID oder seines Benutzerprinzipalnamens in diesen GET-Vorgängen ein Fehler zurückgegeben.If Garth has not shared his default calendar 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: