Ressourcentyp „event“event resource type

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.

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.

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,
  "uid": "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" }],
  "singleValueExtendedProperties": [ { "@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty" }],
  "multiValueExtendedProperties": [ { "@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty" }]
}

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
attendeesattendees attendee-SammlungAttendee collection Die Sammlung der Teilnehmer des Ereignisses.The 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 sind.The categories associated with the event. Jeder Kategorie entspricht der displayName-Eigenschaft einer für den Benutzer definierten outlookCategory.Each category corresponds to the displayName property of an outlookCategory defined for the user.
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 Ereignisses.The 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 hat.Set to true if the event has attachments.
idid ZeichenfolgeString Eindeutiger Bezeichner für das Ereignis.Unique identifier for the classification. Dieser Wert wird standardmäßig geändert, wenn das Element von einem Container (wie einem Ordner oder Kalender) in einen anderen verschoben wird.By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. Um dieses Verhalten zu ändern, verwenden Prefer: IdType="ImmutableId" Sie die Kopfzeile.To change this behavior, use the Prefer: IdType="ImmutableId" header. Weitere Informationen finden Sie unter Abrufen von unveränderlichen Bezeichnern für Outlook-Ressourcen .See Get immutable identifiers for Outlook resources for more information. Schreibgeschützt.Dieser Wert wird standardmäßig geändert, wenn das Element von einem Container (wie einem Ordner oder Kalender) in einen anderen verschoben wird.By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. Um dieses Verhalten zu ändern, verwenden Prefer: IdType="ImmutableId" Sie die Kopfzeile.To change this behavior, use the Prefer: IdType="ImmutableId" header. Weitere Informationen finden Sie unter Abrufen von unveränderlichen Bezeichnern für Outlook-Ressourcen .See Get immutable identifiers for Outlook resources for more information.Read-only.
Wichtigkeitimportance StringString Die Wichtigkeit des Ereignisses.The importance of the event. Mögliche Werte sind: low, normal und high.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 OrtLocation 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. Skype.The property is set only when an organizer specifies an event as an online meeting such as Skype. Schreibgeschützt.Read-only.
organizerorganizer EmpfängerRecipient Der Organisator des Ereignisses.The 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 wurde.Indicates the type of response sent in response to an event message.
sensitivitysensitivity StringString Mögliche Werte: normal, personal, private, confidentialPossible 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 ZeichenfolgeString Der anzuzeigende Status.The status to show. Mögliche Werte sind: free, tentative, busy, oof, workingElsewhere und unknown.Possible values are: free, tentative, busy, oof, workingElsewhere, unknown.
startstart DateTimeTimeZoneDateTimeTimeZone Startdatum, Uhrzeit und Zeitzone des Ereignisses.The 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 ZeichenfolgeString Der Ereignistyp.The event type. Mögliche Werte: singleInstance, occurrence, exception, seriesMaster.Possible values are: singleInstance, occurrence, exception, seriesMaster. SchreibgeschütztRead-only
uiduid 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. Hinweis: Diese Eigenschaft dient dem gleichen Zweck wie die iCalUid-Eigenschaft der Ereignis-Ressource im Version 1.0-Endpunkt, es ist jedoch nicht sicher, dass sie den gleichen Wert besitzt.Note: this property serves the same purpose as the iCalUid property on the event resource on the v1.0 endpoint, but is not guaranteed to have the same value.
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
Anlagenattachments Attachment-SammlungAttachment collection Die Sammlung der FileAttachment-, ItemAttachment- und referenceAttachment-Anlagen für das Ereignis.The collection of FileAttachment, ItemAttachment, and referenceAttachment attachments for the event. Navigationseigenschaft.Navigation property. Schreibgeschützt.Read-only. Lässt Nullwerte zu.Nullable.
Kalendercalendar KalenderCalendar Der Kalender, der das Ereignis enthält. Navigationseigenschaft. Schreibgeschützt.The calendar that contains the event. Navigation property. Read-only.
Erweiterungenextensions ErweiterungssammlungExtension collection Die Sammlung der für das Ereignis definierten offenen Erweiterungen.The collection of open extensions defined for the event. Nullwerte zulassend.Nullable.
instancesinstances Event-SammlungEvent collection Die Instanzen des Ereignisses. Navigationseigenschaft. Schreibgeschützt. Nullwerte zulassend.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. Nullwerte zulassend.The collection of single-value extended properties defined for the event. Read-only. Nullable.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Ereignisse auflistenList events Event-SammlungEvent 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.
cancelcancel KeineNone Sendet Absagen vom Organizer an alle Teilnehmer, und die angegebene Besprechung wird abgesagt.Send cancellation message from the organizer to all the attendees and cancel the specified meeting.
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.
forwardforward KeineNone Ermöglicht es dem Organisator oder Teilnehmer eines Besprechungsereignisses, die Besprechungsanfrage an einen neuen Empfänger weiterzuleiten.Lets the organizer or attendee of a meeting event forward the meeting request to a new recipient.
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 Event-SammlungEvent collection Ruft eine Ereignisobjektsammlung ab.Get a Event object collection.
AnlagenAttachments
Anlagen auflistenList attachments Attachment-SammlungAttachment collection Ruft alle Anlagen für ein Ereignis ab.Get all attachments on an event.
Anlage hinzufügenAdd attachment AnlageAttachment 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 zu einer neuen oder vorhandenen Ressource hinzu.Create an open extension and add custom properties to a new or existing resource.
Offene Erweiterung abrufenGet open extension openTypeExtension-SammlungopenTypeExtension collection Dient zum Abrufen einer offenen Erweiterung, die durch den Erweiterungsnamen identifiziert wird.Get an open extension identified by the extension name.
SchemaerweiterungenSchema extensions
Schemaerweiterungswerte hinzufügenAdd schema extension values Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource.Create a schema extension definition and then use it to add custom typed data to a resource.
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.

Siehe auchSee also