Ressourcentyp „event“

Ein Ereignis in einem Kalender

Diese Ressource unterstützt Folgendes:

  • Hinzufügen Ihrer eigenen Daten zu benutzerdefinierten Eigenschaften mithilfe von Erweiterungen.
  • Verwenden einer Delta-Abfrage zum Nachverfolgen von inkrementellen Hinzufügungen, Löschungen und Aktualisierungen durch Bereitstellen der delta-Funktion.

Methoden

Methode Rückgabetyp Beschreibung
List events Ereignissammlung Ruft eine Liste der event-Objekte im Postfach des Benutzers ab. Die Liste enthält einzelne Instanzen von Besprechungen und Serienmaster.
Ereignis erstellen event Erstellt ein neues Ereignis durch Veröffentlichen in der Instanzensammlung.
Get event event Liest die Eigenschaften und Beziehungen eines Ereignisobjekts.
Update event Aktualisiert das Ereignisobjekt.
Delete Keiner Löscht das Ereignisobjekt.
accept Keiner Nimmt das angegebene Ereignis an.
tentativelyAccept Keiner Nimmt das angegebene Ereignis mit Vorbehalt an.
decline Keiner Lehnt die Einladung zu dem angegebenen Ereignis ab.
delta event-Sammlung 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.
dismissReminder Keiner Schließt die Erinnerung an das angegebene Ereignis.
snoozeReminder Keiner Legt fest, dass erneut an das Ereignis erinnert werden soll.
List instances Ereignissammlung 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.
Anlagen
List attachments attachment collection Ruft alle Anlagen für ein Ereignis ab.
Hinzufügen einer Anlage attachment Fügt einem Ereignis eine neue Anlage durch Veröffentlichen in der Anlagensammlung hinzu.
Offene Erweiterungen
Offene Erweiterung erstellen openTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften in einer neuen oder vorhandenen Instanz einer Ressource hinzu.
Offene Erweiterung abrufen openTypeExtension-Sammlung Ruft ein offenes Erweiterungsobjekt oder Objekte basierend auf ihrem Namen oder vollqualifizierten Namen ab.
Erweiterte Eigenschaften
Create single-value extended property event Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einem neuen oder vorhandenen Ereignis.
Get event with single-value extended property event Ruft mithilfe von $expand oder $filter Ereignisse mit einer bestimmten einwertigen erweiterten Eigenschaft ab.
Create multi-value extended property event Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einem neuen oder vorhandenen Ereignis.
Get event with multi-value extended property event Ruft mithilfe von $expand ein Ereignis mit einer bestimmten mehrwertigen erweiterten Eigenschaft ab.

Eigenschaften

Eigenschaft Typ Beschreibung
attendees attendee collection Die Sammlung der Teilnehmer des Ereignisses
body itemBody Der Text der Nachricht, die dem Ereignis zugeordnet ist. Er kann im HTML- oder Textformat vorliegen.
bodyPreview String Die Vorschau der Nachricht, die dem Ereignis zugeordnet ist. Liegt im Textformat vor.
categories String collection Die Kategorien, die dem Ereignis zugeordnet sind
changeKey String 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.
createdDateTime DateTimeOffset 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'
end dateTimeTimeZone Datum, Uhrzeit und Zeitzone für das Ende des Ereignisses
hasAttachments Boolean „true“, wenn das Ereignis Anlagen hat
iCalUId String Ein eindeutiger Bezeichner, der für alle Instanzen eines Ereignisses in unterschiedlichen Kalendern verwendet wird
id String Schreibgeschützt
importance String Die Wichtigkeit des Ereignisses. Niedrig = 0, Normal = 1, Hoch = 2. Mögliche Werte: Low, Normal, High.
isAllDay Boolean „true“, wenn das Ereignis ein ganztägiges Ereignis ist
isCancelled Boolean „true“, wenn das Ereignis abgesagt wurde
isOrganizer Boolean „true“, wenn der Absender der Nachricht auch der Organisator ist
isReminderOn Boolean „true“, wenn eingestellt ist, dass der Benutzer an das Ereignis erinnert werden soll
lastModifiedDateTime DateTimeOffset 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'
location location Der Ort, an dem das Ereignis stattfindet
onlineMeetingUrl String Eine URL für eine Onlinebesprechung
organizer recipient Der Organisator des Ereignisses
originalEndTimeZone String Die Zeitzone, die bei der Erstellung des Ereignisses für das Ereignisende festgelegt wurde. Der Wert tzone://Microsoft/Custom gibt an, dass eine ältere benutzerdefinierte Zeitzone in Outlook Desktop festgelegt wurde.
originalStart DateTimeOffset 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'
originalStartTimeZone String 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.
recurrence patternedRecurrence Das Serienmuster für das Ereignis.
reminderMinutesBeforeStart Int32 Festlegung, wie viele Minuten vor Beginn des Ereignisses die Erinnerung angezeigt werden soll
responseRequested Boolean „true“, wenn der Absender eine Antwort erhalten soll, sobald das Ereignis angenommen oder abgelehnt wird
responseStatus responseStatus Typ der Antwort, die als Antwort auf eine Ereignisnachricht gesendet wurde
sensitivity String Mögliche Werte: Normal, Personal, Private, Confidential
seriesMasterId String Die dem Element zugeordneten Kategorien
showAs String Der anzuzeigende Status: Frei = 0, Mit Vorbehalt = 1, Beschäftigt = 2, Abwesend = 3, An anderem Ort tätig = 4; Unbekannt =-1. Mögliche Werte: Free, Tentative, Busy, Oof, WorkingElsewhere, Unknown.
start dateTimeTimeZone Datum, Uhrzeit und Zeitzone für den Beginn des Ereignisses
subject String Der Text der Betreffzeile des Ereignisses
type String Der Ereignistyp: SingleInstance = 0, Occurrence = 1, Exception = 2, SeriesMaster = 3. Mögliche Werte: SingleInstance, Occurrence, Exception, SeriesMaster.
webLink String Die URL zum Öffnen des Ereignisses 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.

Auf diese URL kann von einem iFrame aus zugegriffen werden.

Beziehungen

Beziehung Typ Beschreibung
attachments attachment collection Die Sammlung der FileAttachment- und ItemAttachment-Anlagen des Ereignisses. Navigationseigenschaft. Schreibgeschützt Lässt Nullwerte zu.
Kalender Kalender Der Kalender, der das Ereignis enthält. Navigationseigenschaft. Schreibgeschützt
Erweiterungen Erweiterungssammlung Die Sammlung der für das Ereignis definierten offenen Erweiterungen. Schreibgeschützt. Lässt Nullwerte zu.
instances Ereignissammlung Die Instanzen des Ereignisses. Navigationseigenschaft. Schreibgeschützt Lässt Nullwerte zu.
multiValueExtendedProperties multiValueLegacyExtendedProperty-Sammlung Die Sammlung der für das Ereignis definierten mehrwertigen erweiterten Eigenschaften. Schreibgeschützt. Lässt Nullwerte zu.
singleValueExtendedProperties singleValueLegacyExtendedProperty-Sammlung Die Sammlung der für das Ereignis definierten einwertigen erweiterten Eigenschaften. Schreibgeschützt. Lässt Nullwerte zu.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "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"},
  "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" },
  "instances": [ { "@odata.type": "microsoft.graph.event" }]

}

Siehe auch