Ereignisse auflistenList events

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Dient zum Abrufen einer Liste von Ereignissen in einem Kalender.Retrieve a list of events in a calendar. Dies kann ein Kalender für einen Benutzer oder der Standardkalender einer Office 365-Gruppe sein.The calendar can be one for a user, or the default calendar of an Office 365 group. Die Liste der Ereignisse enthält einzelne Instanzen von Besprechungen und Serienmaster.The list of events contains single instance meetings and series masters.

Um erweiterte Ereignisinstanzen abzurufen, können Sie die Kalenderansicht abrufen oder die Instanzen eines Ereignisses abrufen.To get expanded event instances, you can get the calendar view, or get the instances of an event.

BerechtigungenPermissions

Je nach dem Typ des Kalenders, in dem sich die Ereignisse befinden, und dem Typ der Berechtigung (delegierte Berechtigung oder Anwendungsberechtigung), ist eine der folgenden Berechtigungen erforderlich, um diese API aufzurufen.Depending on the type of calendar that the events are in and the permission type (delegated or application) requested, one of the following permissions is required to call this API. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.To learn more, including how to choose permissions, see Permissions.

KalenderCalendar Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) ApplicationApplication
Benutzerkalenderuser calendar Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite
Gruppenkalendergroup calendar Group.Read.All, Group.ReadWrite.AllGroup.Read.All, Group.ReadWrite.All Nicht unterstütztNot supported. Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

Der Standardkalender eines Benutzers oder einer Gruppe.A user's or group's default calendar.

GET /me/calendar/events
GET /users/{id | userPrincipalName}/calendar/events
GET /groups/{id}/calendar/events

Der Kalender eines Benutzers in der standardmäßigen CalendarGroup.A user's calendar in the default calendarGroup.

GET /me/calendars/{id}/events
GET /users/{id | userPrincipalName}/calendars/{id}/events

GET /me/calendarGroup/calendars/{id}/events
GET /users/{id | userPrincipalName}/calendarGroup/calendars/{id}/events

Der Kalender eines Benutzers in einer bestimmten CalendarGroup.A user's calendar in a specific calendarGroup.

GET /me/calendarGroups/{id}/calendars/{id}/events
GET /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.This method supports the OData Query Parameters to help customize the response.

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.
Prefer: outlook.timezonePrefer: outlook.timezone stringstring Verwenden Sie dies, um die Zeitzone für die Anfangs- und Endzeiten in der Antwort anzugeben.Use this to specify the time zone for start and end times in the response. Wenn nicht angegeben, werden diese Zeitwerte in UTC zurückgegeben.If not specified, those time values are returned in UTC. Optional.Optional.

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eine Sammlung von Event-Objekten im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and collection of Event objects in the response body.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

GET https://graph.microsoft.com/beta/me/calendar/events
AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 354

{
  "value": [
    {
      "originalStartTimeZone": "originalStartTimeZone-value",
      "originalEndTimeZone": "originalEndTimeZone-value",
      "responseStatus": {
        "response": "",
        "time": "2016-10-19T10:37:00Z"
      },
      "uid": "iCalUId-value",
      "reminderMinutesBeforeStart": 99,
      "isReminderOn": true
    }
  ]
}