Ressourcentyp calendarcalendar resource type

Namespace: microsoft.graphNamespace: microsoft.graph

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. Es kann ein Kalender für einen Benutzeroder der Standardkalender einer Microsoft 365- Gruppesein.It can be a calendar for a user, or the default calendar of a Microsoft 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. Der Kalender kann einer für einen Benutzer oder der Standardkalender einer Microsoft 365-Gruppe sein.The calendar can be one for a user, or the default calendar of a Microsoft 365 group.
AktualisierenUpdate Kalendercalendar Mit dieser API können Sie die Eigenschaften eines calendar-Objekts aktualisieren.Update the properties of a calendar object. Der Kalender kann einer für einen Benutzer oder der Standardkalender einer Microsoft 365-Gruppe sein.The calendar can be one for a user, or the default calendar of a Microsoft 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
allowedOnlineMeetingProvidersallowedOnlineMeetingProviders Zeichenfolgenauflistungstring collection Stellt die Dienstanbieter für Onlinebesprechungen dar, die in diesem Kalender zum Erstellen von Onlinebesprechungen verwendet werden können.Represent the online meeting service providers that can be used to create online meetings in this calendar. Mögliche Werte: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
calendarGroupIdcalendarGroupId ZeichenfolgeString Das calendarGroup-Objekt, in dem der Kalender erstellt werden soll.The calendarGroup in which to create the calendar. Wenn der Benutzer nie explizit eine Gruppe für den Kalender festgelegt hat, ist diese Eigenschaft "Null".If the user has never explicitly set a group for the calendar, this property is null.
canEditcanEdit BooleschBoolean "True", wenn der Benutzer in den Kalender schreiben kann, andernfalls "false". Diese Eigenschaft gilt für den Benutzer, der den Kalender erstellt hat. Diese Eigenschaft trifft auch zu, wenn ein Benutzer, für den ein Kalender freigegeben und dem Schreibzugriff, über einen Outlook-Client oder die entsprechende calendarPermission-Ressource gewährt wurde. Schreibgeschützt.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, through an Outlook client or the corresponding calendarPermission resource. Read-only.
canSharecanShare BooleanBoolean „True“, wenn der Benutzer die Berechtigung zum Freigeben des Kalenders hat, andernfalls „false“.True if the user has the permission to share the calendar, false otherwise. Nur der Benutzer, der den Kalender erstellt hat, kann ihn freigeben.Only the user who created the calendar can share it. Schreibgeschützt.Read-only.
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. Diese Eigenschaft wird über einen Outlook-Client oder die entsprechende calendarPermission-Ressource festgelegt.This property is set through an Outlook client or the corresponding calendarPermission resource. Schreibgeschützt.Read-only.
changeKeychangeKey StringString 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 ZeichenfolgeString 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
defaultOnlineMeetingProviderdefaultOnlineMeetingProvider onlineMeetingProviderTypeonlineMeetingProviderType Der standardmäßige Anbieter für Onlinebesprechungen, die aus diesem Kalender gesendet wurden.The default online meeting provider for meetings sent from this calendar. Mögliche Werte: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
hexColorhexColor StringString Die Kalenderfarbe, die in einem hexadezimalen Farbcode mit drei Hexadezimalwerten angegeben ist, die jeweils von 00 bis FF reichen und die roten, grünen oder blauen Komponenten der Farbe im RGB-Farbraum darstellen.The calendar color, expressed in a hex color code of three hexidecimal values, each ranging from 00 to FF and representing the red, green, or blue components of the color in the RGB color space. Wenn der Benutzer nie explizit eine Farbe für den Kalender festgelegt hat, ist diese Eigenschaft leer.If the user has never explicitly set a color for the calendar, this property is empty.
idid ZeichenfolgeString Eindeutiger Bezeichner des Kalenders. Schreibgeschützt.The calendar's unique identifier. Read-only.
isDefaultCalendarisDefaultCalendar BooleanBoolean „True“, wenn es sich um den Standardkalender handelt, in dem neue Ereignisse standardmäßig erstellt werden, andernfalls „false“.True if this is the default calendar where new events are created by default, false otherwise.
isRemovableisRemovable BooleanBoolean Gibt an, ob dieser Benutzerkalender aus dem Benutzerpostfach gelöscht werden kann.Indicates whether this user calendar can be deleted from the user mailbox.
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. Diese Eigenschaft wird beim Initiieren der Freigabe in einem Outlook-Client festgelegt und kann zurückgesetzt werden, wenn die Freigabe über den Client oder die entsprechende calendarPermission-Ressource aufgehoben wird.This property is set when sharing is initiated in an Outlook client, and can be reset when the sharing is cancelled through the client or the corresponding calendarPermission resource. Schreibgeschützt.Read-only.
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. Diese Eigenschaft wird beim Initiieren der Freigabe in einem Outlook-Client festgelegt und kann zurückgesetzt werden, wenn die Freigabe über den Client oder die entsprechende calendarPermission-Ressource aufgehoben wird.This property is set when sharing is initiated in an Outlook client, and can be reset when the sharing is cancelled through the client or the corresponding calendarPermission resource. Schreibgeschützt.Read-only.
isTallyingResponsesisTallyingResponses BooleanBoolean Gibt an, ob dieser Benutzerkalender die Nachverfolgung von Besprechungsantworten unterstützt.Indicates whether this user calendar supports tracking of meeting responses. Nur Besprechungseinladungen, die aus den primären Kalendern der Benutzer gesendet wurden, unterstützen das Nachverfolgen von Besprechungsantworten.Only meeting invites sent from users' primary calendars support tracking of meeting responses.
Namename StringString Der Kalendername.The calendar name.
ownerowner emailAddressemailAddress Wenn festgelegt, stellt dies den Benutzer dar, der den Kalender erstellt oder hinzugefügt hat.If set, this represents the user who created or added the calendar. Für einen Kalender, den der Benutzer erstellt oder hinzugefügt hat, wird die Eigenschaft owner auf den Benutzer festgelegt.For a calendar that the user created or added, the owner property is set to the user. 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.For a calendar shared with the user, the owner property is set to the person who shared that calendar with the user. Schreibgeschützt.Read-only.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
calendarPermissionscalendarPermissions calendarPermission-SammlungcalendarPermission collection Die Berechtigungen der Benutzer, für die der Kalender freigegeben ist.The permissions of the users with whom the calendar is shared.
calendarViewcalendarView event-Sammlungevent collection Die Kalenderansicht für den Kalender. Navigationseigenschaft. Schreibgeschützt.The calendar view for the calendar. Navigation property. Read-only.
eventsevents 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

{
  "allowedOnlineMeetingProviders": ["string"],
  "canEdit": "boolean",
  "canShare": "boolean",
  "canViewPrivateItems": "boolean",
  "changeKey": "string",
  "color": "String",
  "defaultOnlineMeetingProvider": "string",
  "hexColor": "String",
  "id": "string (identifier)",
  "isDefaultCalendar": "boolean",
  "isRemovable": "boolean",
  "isShared": "boolean",
  "isSharedWithMe": "boolean",
  "isTallyingResponses": "boolean",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}
}