Ressourcentyp „event“event resource type

Ein Ereignis in einem Kalender für einen Benutzer oder der Standardkalender einer Office 365-Gruppe.An event in a user calendar, or the default calendar of an Office 365 group.

Diese Ressource unterstützt Folgendes:This resource supports:

Hinweis: Es gibt einige kleinere Unterschiede in der Weise, wie Sie mit Benutzerkalendern, Gruppenkalendern und den dazugehörigen Ereignissen interagieren können:Note: There are a few minor differences in the way you can interact with user calendars, group calendars, and their events:

  • Benutzerkalender können Sie nur in einer CalendarGroup organisieren.You can organize only user calendars in a calendarGroup.
  • Outlook akzeptiert automatisch alle Besprechungsanfragen im Auftrag von Gruppen.Outlook automatically accepts all meeting requests on behalf of groups. Das Annehmen, Mit Vorbehalt annehmen oder Ablehnen von Besprechungsanfragen ist nur bei Kalendern für Benutzer möglich.You can accept, tentatively accept, or decline meeting requests for user calendars only.
  • Outlook unterstützt keinen Erinnerungen für Gruppenereignisse.Outlook doesn't support reminders for group events. Das Erneute Erinnern oder Schließen einer Erinnerung ist nur bei Kalendern für Benutzer möglich.You can snooze or dismiss a reminder for user calendars only.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
List eventsList events Ereignissammlungevent collection Ruft eine Liste der event-Objekte im Postfach des Benutzers ab. Die Liste enthält einzelne Instanzen von Besprechungen und Serienmaster.Retrieve a list of event objects in the user's mailbox. The list contains single instance meetings and series masters.
Ereignis erstellenCreate event eventevent Erstellt ein neues Ereignis durch Veröffentlichen in der Instanzensammlung.Create a new event by posting to the instances collection.
Get eventGet event eventevent Liest die Eigenschaften und Beziehungen eines Ereignisobjekts.Read properties and relationships of event object.
UpdateUpdate eventevent Aktualisiert das Ereignisobjekt.Update event object.
DeleteDelete KeinerNone Löscht das Ereignisobjekt.Delete event object.
acceptaccept KeineNone Akzeptiert das angegebene Ereignis in einem Benutzerkalender.Accept the specified event in a user calendar.
tentativelyAccepttentativelyAccept KeineNone Akzeptiert mit Vorbehalt das angegebene Ereignis in einem Benutzerkalender.Tentatively accept the specified event in a user calendar.
declinedecline KeineNone Lehnt die Einladung zu einem in einem Benutzerkalender angegebenen Ereignis ab.Decline invitation to the specified event in a user calendar.
deltadelta event-Sammlungevent collection Dient zum Abrufen einer Reihe von Ereignissen, die in einer calendarView (ein Bereich von Ereignissen) im primären Kalender des Benutzers hinzugefügt, gelöscht oder aktualisiert wurden.Get a set of events that have been added, deleted, or updated in a calendarView (a range of events) of the user's primary calendar.
dismissReminderdismissReminder KeineNone Schließt die Erinnerung an das angegebene Ereignis in einem Benutzerkalender.Dismiss the reminder for the specified event in a user calendar.
snoozeRemindersnoozeReminder KeineNone Verschiebt die Erinnerung an das angegebene Ereignis in einem Benutzerkalender bis zu einem neuen Termin.Postpone a reminder for the specified event in a user calendar until a new time.
List instancesList instances Ereignissammlungevent collection Ruft alle Instanzen (Vorkommen) eines Ereignisses ab, die innerhalb eines angegebenen Zeitraums existieren. Wenn das Ereignis vom Typ SeriesMaster ist, werden hierdurch alle Vorkommen und Ausnahmen des Ereignisses zurückgegeben, die innerhalb des angegebenen Zeitraums existieren.Get the instances (occurrences) of an event for a specified time range. If the event is a SeriesMaster type, this returns the occurrences and exceptions of the event in the specified time range.
AnlagenAttachments
List attachmentsList attachments attachment collectionattachment collection Ruft alle Anlagen für ein Ereignis ab.Get all attachments on an event.
Hinzufügen einer AnlageAdd attachment attachmentattachment Fügt einem Ereignis eine neue Anlage durch Veröffentlichen in der Anlagensammlung hinzu.Add a new attachment to an event by posting to the attachments collection.
Offene ErweiterungenOpen extensions
Offene Erweiterung erstellenCreate open extension openTypeExtensionopenTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften in einer neuen oder vorhandenen Instanz einer Ressource hinzu.Create an open extension and add custom properties in a new or existing instance of a resource.
Offene Erweiterung abrufenGet open extension openTypeExtension-SammlungopenTypeExtension collection Ruft ein offenes Erweiterungsobjekt oder Objekte basierend auf ihrem Namen oder vollqualifizierten Namen ab.Get an open extension object or objects identified by name or fully qualified name.
Erweiterte EigenschaftenExtended properties
Create single-value extended propertyCreate single-value extended property eventevent Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einem neuen oder vorhandenen Ereignis.Create one or more single-value extended properties in a new or existing event.
Get event with single-value extended propertyGet event with single-value extended property eventevent Ruft mithilfe von $expand oder $filter Ereignisse mit einer bestimmten einwertigen erweiterten Eigenschaft ab.Get events that contain a single-value extended property by using $expand or $filter.
Create multi-value extended propertyCreate multi-value extended property eventevent Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einem neuen oder vorhandenen Ereignis.Create one or more multi-value extended properties in a new or existing event.
Get event with multi-value extended propertyGet event with multi-value extended property eventevent Ruft mithilfe von $expand ein Ereignis mit einer bestimmten mehrwertigen erweiterten Eigenschaft ab.Get an event that contains a multi-value extended property by using $expand.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
attendeesattendees attendee collectionattendee collection Die Sammlung der Teilnehmer des EreignissesThe collection of attendees for the event.
bodybody itemBodyitemBody Der Text der Nachricht, die dem Ereignis zugeordnet ist. Er kann im HTML- oder Textformat vorliegen.The body of the message associated with the event. It can be in HTML or text format.
bodyPreviewbodyPreview StringString Die Vorschau der Nachricht, die dem Ereignis zugeordnet ist. Liegt im Textformat vor.The preview of the message associated with the event. It is in text format.
categoriescategories String collectionString collection Die Kategorien, die dem Ereignis zugeordnet sindThe categories associated with the event.
changeKeychangeKey StringString Gibt die Version des Ereignisobjekts an. Jedes Mal, wenn das Ereignis geändert wird, wird auch die Eigenschaft „changeKey“ geändert. Auf diese Weise kann Exchange Änderungen an der korrekten Version des Objekts vornehmen.Identifies the version of the event object. Every time the event is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
endend dateTimeTimeZonedateTimeTimeZone Datum, Uhrzeit und Zeitzone für das Ende des EreignissesThe date, time, and time zone that the event ends. Standardmäßig ist die Endzeit in UTC angegeben.By default, the end time is in UTC.
hasAttachmentshasAttachments BooleanBoolean „true“, wenn das Ereignis Anlagen hatSet to true if the event has attachments.
iCalUIdiCalUId StringString Ein eindeutiger Bezeichner, der für alle Instanzen eines Ereignisses in unterschiedlichen Kalendern verwendet wird.A unique identifier that is shared by all instances of an event across different calendars. Schreibgeschützt.Read-only.
idid StringString SchreibgeschütztRead-only.
Wichtigkeitimportance Wichtigkeitimportance Die Wichtigkeit des Ereignisses.The importance of the event. Die möglichen Werte sind: low, normal, high.The possible values are: low, normal, high.
isAllDayisAllDay BooleanBoolean „true“, wenn das Ereignis ein ganztägiges Ereignis istSet to true if the event lasts all day.
isCancelledisCancelled BooleanBoolean „true“, wenn das Ereignis abgesagt wurdeSet to true if the event has been canceled.
isOrganizerisOrganizer BooleanBoolean „true“, wenn der Absender der Nachricht auch der Organisator istSet to true if the message sender is also the organizer.
isReminderOnisReminderOn BooleanBoolean „true“, wenn eingestellt ist, dass der Benutzer an das Ereignis erinnert werden sollSet to true if an alert is set to remind the user of the event.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
locationlocation locationlocation Der Ort des Ereignisses.The location of the event.
locationslocations location-Sammlunglocation collection Die Orte, an denen die Veranstaltung stattfindet.The locations where the event is held or attended from. Die Eigenschaften location und locations entsprechen sich immer gegenseitig.The location and locations properties always correspond with each other. Wenn Sie die location-Eigenschaft aktualisieren, werden alle früheren Orte in der locations-Sammlung entfernt und durch den neuen location-Wert ersetzt.If you update the location property, any prior locations in the locations collection would be removed and replaced by the new location value.
onlineMeetingUrlonlineMeetingUrl StringString Eine URL für eine Onlinebesprechung.A URL for an online meeting. Die Eigenschaft wird nur angegeben, wenn ein Organisator ein Ereignis als Onlinebesprechung festlegt, wie z. B. eine Skype-Besprechung.The property is set only when an organizer specifies an event as an online meeting such as a Skype meeting. Schreibgeschützt.Read-only.
organizerorganizer recipientrecipient Der Organisator des EreignissesThe organizer of the event.
originalEndTimeZoneoriginalEndTimeZone StringString Die Zeitzone, die bei der Erstellung des Ereignisses für das Ereignisende festgelegt wurde.The end time zone that was set when the event was created. Der Wert tzone://Microsoft/Custom gibt an, dass eine ältere benutzerdefinierte Zeitzone in Outlook Desktop festgelegt wurde.A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
originalStartoriginalStart DateTimeOffsetDateTimeOffset Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
originalStartTimeZoneoriginalStartTimeZone StringString Die Zeitzone, die bei der Erstellung des Ereignisses für den Ereignisbeginn festgelegt wurde. Der Wert tzone://Microsoft/Custom gibt an, dass eine ältere benutzerdefinierte Zeitzone in Outlook Desktop festgelegt wurde.The start time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
recurrencerecurrence patternedRecurrencepatternedRecurrence Das Serienmuster für das Ereignis.The recurrence pattern for the event.
reminderMinutesBeforeStartreminderMinutesBeforeStart Int32Int32 Festlegung, wie viele Minuten vor Beginn des Ereignisses die Erinnerung angezeigt werden sollThe number of minutes before the event start time that the reminder alert occurs.
responseRequestedresponseRequested BooleanBoolean „true“, wenn der Absender eine Antwort erhalten soll, sobald das Ereignis angenommen oder abgelehnt wirdSet to true if the sender would like a response when the event is accepted or declined.
responseStatusresponseStatus responseStatusresponseStatus Typ der Antwort, die als Antwort auf eine Ereignisnachricht gesendet wurdeIndicates the type of response sent in response to an event message.
sensitivitysensitivity sensitivitysensitivity Mögliche Werte sind: normal, personal, private, confidential.The possible values are: normal, personal, private, confidential.
seriesMasterIdseriesMasterId StringString Die ID für das Terminserien-Masterelement, wenn das Ereignis zu einer Terminserie gehört.The ID for the recurring series master item, if this event is part of a recurring series.
showAsshowAs freeBusyStatusfreeBusyStatus Der anzuzeigende Status.The status to show. Mögliche Werte sind: free, tentative, busy, oof, workingElsewhere, unknown.The possible values are: free, tentative, busy, oof, workingElsewhere, unknown.
startstart dateTimeTimeZonedateTimeTimeZone Datum, Uhrzeit und Zeitzone für den Beginn des EreignissesThe date, time, and time zone that the event starts. Standardmäßig ist die Startzeit in UTC angegeben.By default, the start time is in UTC.
subjectsubject StringString Der Text der Betreffzeile des EreignissesThe text of the event's subject line.
typetype eventTypeeventType Der Ereignistyp.The event type. Mögliche Werte sind: singleInstance, occurrence, exception, seriesMaster.The possible values are: singleInstance, occurrence, exception, seriesMaster. Schreibgeschützt.Read-only.
webLinkwebLink StringString Die URL zum Öffnen des Ereignisses in Outlook Web App:The URL to open the event in Outlook Web App.

Das Ereignis wird im Browser geöffnet, wenn Sie über Outlook Web App bei Ihrem Postfach angemeldet sind. Sie werden aufgefordert, sich anzumelden, wenn Sie noch nicht beim Browser angemeldet sind.The event will open in the browser if you are logged in to your mailbox via Outlook Web App. You will be prompted to login if you are not already logged in with the browser.

Auf diese URL kann von einem iFrame aus zugegriffen werden.This URL can be accessed from within an iFrame.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
attachmentsattachments attachment collectionattachment collection Die Sammlung der FileAttachment- und ItemAttachment-Anlagen des Ereignisses. Navigationseigenschaft. Schreibgeschützt Lässt Nullwerte zu.The collection of fileAttachment and itemAttachment attachments for the event. Navigation property. Read-only. Nullable.
Kalendercalendar Kalendercalendar Der Kalender, der das Ereignis enthält. Navigationseigenschaft. SchreibgeschütztThe calendar that contains the event. Navigation property. Read-only.
Erweiterungenextensions ErweiterungssammlungExtension collection Die Sammlung der für das Ereignis definierten offenen Erweiterungen. Schreibgeschützt. Lässt Nullwerte zu.The collection of open extensions defined for the event. Read-only. Nullable.
instancesinstances Ereignissammlungevent collection Die Instanzen des Ereignisses. Navigationseigenschaft. Schreibgeschützt Lässt Nullwerte zu.The instances of the event. Navigation property. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty-SammlungmultiValueLegacyExtendedProperty collection Die Sammlung der für das Ereignis definierten mehrwertigen erweiterten Eigenschaften. Schreibgeschützt. Lässt Nullwerte zu.The collection of multi-value extended properties defined for the event. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty-SammlungsingleValueLegacyExtendedProperty collection Die Sammlung der für das Ereignis definierten einwertigen erweiterten Eigenschaften. Schreibgeschützt. Lässt Nullwerte zu.The collection of single-value extended properties defined for the event. Read-only. Nullable.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource

{
  "attendees": [{"@odata.type": "microsoft.graph.attendee"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "categories": ["string"],
  "changeKey": "string",
  "createdDateTime": "String (timestamp)",
  "end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "hasAttachments": true,
  "iCalUId": "string",
  "id": "string (identifier)",
  "importance": "String",
  "isAllDay": true,
  "isCancelled": true,
  "isOrganizer": true,
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "location": {"@odata.type": "microsoft.graph.location"},
  "locations": [{"@odata.type": "microsoft.graph.location"}],
  "onlineMeetingUrl": "string",
  "organizer": {"@odata.type": "microsoft.graph.recipient"},
  "originalEndTimeZone": "string",
  "originalStart": "String (timestamp)",
  "originalStartTimeZone": "string",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "reminderMinutesBeforeStart": 1024,
  "responseRequested": true,
  "responseStatus": {"@odata.type": "microsoft.graph.responseStatus"},
  "sensitivity": "String",
  "seriesMasterId": "string",
  "showAs": "String",
  "start": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "string",
  "type": "String",
  "webLink": "string",

  "attachments": [ { "@odata.type": "microsoft.graph.attachment" } ],
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "extensions": [ { "@odata.type": "microsoft.graph.extension" } ],
  "instances": [ { "@odata.type": "microsoft.graph.event" }],
  "multiValueExtendedProperties": [ { "@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty" }],
  "singleValueExtendedProperties": [ { "@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty" }]

}

Siehe auchSee also