Ressourcentyp calendarcalendar 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 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 in der Weise, wie Sie mit Benutzerkalendern und Gruppenkalendern 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 eventevent Dient zum Erstellen eines neuen Ereignisses im Standardkalender oder im angegebenen Kalender.Create a new event in the default or specified calendar.
getSchedulegetSchedule scheduleInformation-SammlungscheduleInformation collection Rufen Sie die Frei/Gebucht-Informationen zur Verfügbarkeit von Benutzern, Verteilerlisten oder Ressourcen für einen angegebenen Zeitraum ab.Get the free/busy availability information for a collection of users, distributions lists, or resources, for a specified time period.
findMeetingTimesfindMeetingTimes meetingTimeSuggestionsResultmeetingTimeSuggestionsResult Schlägt Besprechungszeiten und -orte basierend auf der Verfügbarkeit des Organisators und der Teilnehmer sowie auf spezifizierten Zeit- oder Ortseinschränkungen vor.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 StringString 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
hexColorhexColor StringString Eine Farbe, die den Kalender repräsentiert.A color representing the calendar. Die Farbe wird durch eine 6-stellige hexadezimale Zahl aus 3-Byte-Zeichen dargestellt.The color is represented by a 6-digit, 3-byte hexadecimal number. Jedes Byte stellt eine der roten, grünen und blauen Komponenten der Farbe im Bereich von 00 bis FF in hexadezimaler Schreibweise dar.Each byte represents one of the red, green, and blue components of the color, in the range 00 to FF in hexadecimal notation.
idid StringString Eindeutiger Bezeichner für die Gruppe. Schreibgeschützt.The group's unique identifier. Read-only.
isDefaultCalendarisDefaultCalendar Boolescher WertBoolean „True“, wenn der Kalender der Standardkalender des Benutzers ist, andernfalls „false“.True if this calendar is the user's default calendar, false otherwise.
isSharedisShared Boolescher WertBoolean „True“, wenn der Benutzer den Kalender für andere Benutzer freigegeben hat, andernfalls „false“.True if the user has shared the calendar with other users, false otherwise. Da nur der Benutzer, der den Kalender erstellt hat, den Kalender freigeben kann, können IsShared und IsSharedWithMe nicht für denselben Benutzer „true“ sein.Since only the user who created the calendar can share it, isShared and isSharedWithMe cannot be true for the same user.
isSharedWithMeisSharedWithMe Boolescher WertBoolean „True“, wenn der Benutzer diesen Kalender freigegeben hat, andernfalls „false“.True if the user has been shared this calendar, false otherwise. Diese Eigenschaft ist für einen Kalenderbesitzer immer „false“.This property is always false for a calendar owner.
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 event-Sammlungevent collection Die Kalenderansicht für den Kalender. Navigationseigenschaft. Schreibgeschützt.The calendar view for the calendar. Navigation property. Read-only.
Ereignisseevents event-Sammlungevent 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",
  "hexColor": "String",
  "id": "string (identifier)",
  "isDefaultCalendar": "boolean",
  "isShared": "boolean",
  "isSharedWithMe": "boolean",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}
}