Ressourcentyp calendarcalendar resource type

Ein Kalender, der ein Container für Ereignisse ist.A calendar which is a container for events. Dies kann ein Kalender für einen Benutzer oder der Standardkalender einer Office 365-Gruppe sein.It can be a calendar for a user, or the default calendar of an Office 365 group.

Hinweis: Es gibt einige kleinere Unterschiede bei der Verarbeitung von Benutzerkalender und Gruppenkalender interagieren können:Note: There are a few minor differences in the way you can interact with user calendars and group calendars:

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Kalender auflistenList calendars calender-Sammlungcalendar collection Rufen Sie alle Kalender des Benutzers oder die Kalender auf der Standardgruppe oder einer anderen bestimmten Kalendergruppe ab.Get all the user's calendars, or the calendars in the default or other specific calendar group.
Kalender erstellenCreate calendar Kalendercalendar Erstellen Sie einen neuen Kalender in der Standardkalendergruppe oder in der angegebenen Kalendergruppe für einen Benutzer.Create a new calendar in the default calendar group or specified calendar group for a user.
Kalender abrufenGet calendar Kalendercalendar Dient zum Abrufen der Eigenschaften und der Beziehungen eines calendar-Objekts.Get the properties and relationships of a calendar object. 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.
AktualisierenUpdate Kalendercalendar Mit dieser API können Sie die Eigenschaften eines calendar-Objekts aktualisieren.Update the properties of a calendar object. 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.
LöschenDelete KeineNone Dient zum Löschen des Kalenderobjekts aktualisieren.Delete calendar object.
calendarView auflistenList calendarView Ereignissammlungevent collection Dient zum Abrufen der Vorkommen, Ausnahmen und einzelnen Instanzen von Ereignissen in einer Kalenderansicht, die durch eine Zeitbereich definiert werden, aus dem primären Kalender (../me/calendarview) des Benutzers oder aus einem angegebenen Kalender.Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's primary calendar (../me/calendarview) or from a specified calendar.
Ereignisse auflistenList events Ereignissammlungevent collection Dient zum Abrufen einer Liste von Ereignissen in einem Kalender. Die Liste enthält einzelne Instanzen von Besprechungen und Serienmaster.Retrieve a list of events in a calendar. The list contains single instance meetings and series masters.
Ereignis erstellenCreate event Ereignisevent Erstellen Sie ein neues Ereignis in die standardmäßigen oder den angegebenen Kalender.Create a new event in the default or specified calendar.
findMeetingTimesfindMeetingTimes meetingTimeSuggestionsResultmeetingTimeSuggestionsResult Schlagen Sie vor Besprechungszeiten und Speicherorte basierend auf der Organisator und Teilnehmer Verfügbarkeit und Zeit oder Ort Einschränkungen.Suggest meeting times and locations based on organizer and attendee availability, and time or location constraints.
Einwertige erweiterte Eigenschaft erstellenCreate single-value extended property Kalendercalendar Dient zum Erstellen einer oder mehrerer erweiterter einwertiger Eigenschaften in einem neuen oder vorhandenen Kalender.Create one or more single-value extended properties in a new or existing calendar.
Kalender mit einwertiger erweiterter Eigenschaft abrufenGet calendar with single-value extended property Kalendercalendar Ruft mithilfe von $expand oder $filter Kalender mit einer einwertigen erweiterten Eigenschaft ab.Get calendars that contain a single-value extended property by using $expand or $filter.
Mehrwertige erweiterte Eigenschaft erstellenCreate multi-value extended property Kalendercalendar Dient zum Erstellen einer oder mehrerer erweiterter mehrwertiger Eigenschaften in einem neuen oder vorhandenen Kalender.Create one or more multi-value extended properties in a new or existing calendar.
Kalender mit mehrwertiger erweiterter Eigenschaft abrufenGet calendar with multi-value extended property Kalendercalendar Dient zum Abrufen eines Kalenders mit einer erweiterten mehrwertigen Eigenschaft mithilfe von $expand.Get a calendar that contains a multi-value extended property by using $expand.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
canEditcanEdit Boolescher WertBoolean „True“, wenn der Benutzer in den Kalender schreiben kann, andernfalls „false“. Diese Eigenschaft ist für den Benutzer, der den Kalender erstellt hat, „true“. Diese Eigenschaft ist auch für einen Benutzer „true“, für den ein Kalender freigegeben wurde und der Schreibzugriff hat.True if the user can write to the calendar, false otherwise. This property is true for the user who created the calendar. This property is also true for a user who has been shared a calendar and granted write access.
canSharecanShare Boolescher WertBoolean „True“, wenn der Benutzer die Berechtigung zum Freigeben des Kalenders hat, andernfalls „false“. Nur der Benutzer, der den Kalender erstellt hat, kann ihn freigeben.True if the user has the permission to share the calendar, false otherwise. Only the user who created the calendar can share it.
canViewPrivateItemscanViewPrivateItems BooleanBoolean „True“, wenn der Benutzer Elemente im Kalender lesen kann, die als „privat“ markiert wurden, andernfalls „false“.True if the user can read calendar items that have been marked private, false otherwise.
changeKeychangeKey ZeichenfolgeString Gibt die Version des Kalenderobjekts an. Jedes Mal, wenn der Kalender geändert wird, wird auch „changeKey“ geändert. Auf diese Weise kann Exchange Änderungen an der korrekten Version des Objekts vornehmen. Schreibgeschützt.Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.
colorcolor calendarColorcalendarColor Gibt das Farbdesign an, um den Kalender von anderen Kalendern in einer Benutzeroberfläche zu unterscheiden. Die Eigenschaftswerte sind: LightBlue=0, LightGreen=1, LightOrange=2, LightGray=3, LightYellow=4, LightTeal=5, LightPink=6, LightBrown=7, LightRed=8, MaxColor=9, Auto=-1Specifies the color theme to distinguish the calendar from other calendars in a UI. The property values are: LightBlue=0, LightGreen=1, LightOrange=2, LightGray=3, LightYellow=4, LightTeal=5, LightPink=6, LightBrown=7, LightRed=8, MaxColor=9, Auto=-1
idid StringString Eindeutiger Bezeichner für die Gruppe. Schreibgeschützt.The group's unique identifier. Read-only.
namename StringString Der Kalendername.The calendar name.
ownerowner emailAddressemailAddress Wenn festgelegt, stellt dies den Benutzer dar, der den Kalender erstellt oder hinzugefügt hat. Für einen Kalender, den der Benutzer erstellt oder hinzugefügt hat, wird die Eigenschaft owner auf den Benutzer festgelegt. Für einen Kalender, der für den Benutzer freigegeben wurde, wird die Eigenschaft owner auf die Person festgelegt, die den Kalender für den Benutzer freigegeben hat.If set, this represents the user who created or added the calendar. For a calendar that the user created or added, the owner property is set to the user. For a calendar shared with the user, the owner property is set to the person who shared that calendar with the user.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
calendarViewcalendarView EreignissammlungEvent collection Die Kalenderansicht für den Kalender. Navigationseigenschaft. Schreibgeschützt.The calendar view for the calendar. Navigation property. Read-only.
eventsevents EreignissammlungEvent collection Die Ereignisse im Kalender. Navigationseigenschaft. Schreibgeschützt.The events in the calendar. Navigation property. Read-only.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty-SammlungmultiValueLegacyExtendedProperty collection Die Sammlung erweiterter mehrwertiger Eigenschaften, die für den Kalender definiert sind. Schreibgeschützt. Lässt NULL-Werte zu.The collection of multi-value extended properties defined for the calendar. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty-SammlungsingleValueLegacyExtendedProperty collection Die Sammlung erweiterter einwertiger Eigenschaften, die für den Kalender definiert sind. Schreibgeschützt. Lässt NULL-Werte zu.The collection of single-value extended properties defined for the calendar. Read-only. Nullable.

JSON-DarstellungJSON representation

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

{
  "canEdit": "boolean",
  "canShare": "boolean",
  "canViewPrivateItems": "boolean",
  "changeKey": "string",
  "color": "String",
  "id": "string (identifier)",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}
}