Teilen über


Ressourcentyp calendar

Namespace: microsoft.graph

Stellt einen Container für Ereignis-Ressourcen dar. Dies kann ein Kalender für einen Benutzer oder der Standardkalender einer Microsoft 365-Gruppe sein.

Hinweis: Es gibt einige kleinere Unterschiede in der Weise, wie Sie mit Benutzerkalendern und Gruppenkalendern interagieren können:

Methoden

Methode Rückgabetyp Beschreibung
Kalender auflisten calender-Sammlung Rufen Sie alle Kalender des Benutzers oder die Kalender auf der Standardgruppe oder einer anderen bestimmten Kalendergruppe ab.
Kalender erstellen Kalender Erstellen Sie einen neuen Kalender in der Standardkalendergruppe oder in der angegebenen Kalendergruppe für einen Benutzer.
Kalender abrufen Kalender Dient zum Abrufen der Eigenschaften und der Beziehungen eines calendar-Objekts. Dies kann ein Kalender für einen Benutzer oder der Standardkalender einer Microsoft 365-Gruppe sein.
Kalender aktualisieren Kalender Mit dieser API können Sie die Eigenschaften eines calendar-Objekts aktualisieren. Dies kann ein Kalender für einen Benutzer oder der Standardkalender einer Microsoft 365-Gruppe sein.
Kalender löschen Keine Dient zum Löschen des Kalenderobjekts aktualisieren.
Kalenderansicht auflisten Ereignissammlung 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.
Ereignisse auflisten Ereignissammlung Dient zum Abrufen einer Liste von Ereignissen in einem Kalender. Die Liste enthält einzelne Instanzen von Besprechungen und Serienmaster.
Ereignis erstellen event Dient zum Erstellen eines neuen Ereignisses im Standardkalender oder im angegebenen Kalender.
Abrufen des Frei-/Gebucht-Zeitplans scheduleInformation-Sammlung Rufen Sie die Frei/Gebucht-Informationen zur Verfügbarkeit von Benutzern, Verteilerlisten oder Ressourcen für einen angegebenen Zeitraum ab.
Besprechungszeiten suchen meetingTimeSuggestionsResult Schlägt Besprechungszeiten und -orte basierend auf der Verfügbarkeit des Organisators und der Teilnehmer sowie auf spezifizierten Zeit- oder Ortseinschränkungen vor.
Einwertige Eigenschaft erstellen Kalender Dient zum Erstellen einer oder mehrerer erweiterter einwertiger Eigenschaften in einem neuen oder vorhandenen Kalender.
Einwertige Eigenschaft abrufen Kalender Ruft mithilfe von $expand oder $filter Kalender mit einer einwertigen erweiterten Eigenschaft ab.
Erstellen einer mehrwertigen Eigenschaft Kalender Dient zum Erstellen einer oder mehrerer erweiterter mehrwertiger Eigenschaften in einem neuen oder vorhandenen Kalender.
Abrufen einer mehrwertigen Eigenschaft Kalender Dient zum Abrufen eines Kalenders mit einer erweiterten mehrwertigen Eigenschaft mithilfe von $expand.

Eigenschaften

Eigenschaft Typ Beschreibung
allowedOnlineMeetingProviders onlineMeetingProviderType collection Stellt die Dienstanbieter für Onlinebesprechungen dar, die in diesem Kalender zum Erstellen von Onlinebesprechungen verwendet werden können. Mögliche Werte: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
canEdit Boolesch 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.
canShare Boolean true, wenn der Benutzer die Berechtigung hat, den Kalender freizugeben, andernfalls false. Nur der Benutzer, der den Kalender erstellt hat, kann ihn freigeben.
canViewPrivateItems Boolean true, wenn der Benutzer Elemente im Kalender lesen kann, die als „privat“ markiert wurden, andernfalls false.
changeKey String Gibt die Version des Kalenderobjekts an. Jedes Mal, wenn der Kalender geändert wird, ändert sich auch changeKey. Auf diese Weise kann Exchange Änderungen an der korrekten Version des Objekts vornehmen. Schreibgeschützt.
color calendarColor Gibt das Farbdesign an, um den Kalender von anderen Kalendern in einer Benutzeroberfläche zu unterscheiden. Die Eigenschaftswerte sind: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColor.
defaultOnlineMeetingProvider onlineMeetingProviderType Der standardmäßige Anbieter für Onlinebesprechungen, die aus diesem Kalender gesendet wurden. Mögliche Werte: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
hexColor String 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. Wenn der Benutzer nie explizit eine Farbe für den Kalender festgelegt hat, ist diese Eigenschaft leer. Schreibgeschützt.
id Zeichenfolge Eindeutiger Bezeichner des Kalenders. Schreibgeschützt.
isDefaultCalendar Boolesch true, wenn es sich um den Standardkalender handelt, in dem neue Ereignisse standardmäßig erstellt werden, andernfalls false.
isRemovable Boolesch Gibt an, ob dieser Benutzerkalender aus dem Benutzerpostfach gelöscht werden kann.
isTallyingResponses Boolesch Gibt an, ob dieser Benutzerkalender die Nachverfolgung von Besprechungsantworten unterstützt. Nur Besprechungseinladungen, die aus den primären Kalendern der Benutzer gesendet wurden, unterstützen das Nachverfolgen von Besprechungsantworten.
Name String Der Kalendername.
owner emailAddress 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.

Beziehungen

Beziehung Typ Beschreibung
calendarPermissions calendarPermission-Sammlung Die Berechtigungen der Benutzer, für die der Kalender freigegeben ist.
calendarView Event collection Die Kalenderansicht für den Kalender. Navigationseigenschaft. Schreibgeschützt.
events Ereignissammlung Die Ereignisse im Kalender. Navigationseigenschaft. Schreibgeschützt.
multiValueExtendedProperties multiValueLegacyExtendedProperty-Sammlung Die Sammlung erweiterter mehrwertiger Eigenschaften, die für den Kalender definiert sind. Schreibgeschützt. Nullwerte zulassend.
singleValueExtendedProperties singleValueLegacyExtendedProperty-Sammlung Die Sammlung erweiterter einwertiger Eigenschaften, die für den Kalender definiert sind. Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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