Ressourcentyp calendar

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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
List calender-Sammlung Rufen Sie alle Kalender des Benutzers oder die Kalender auf der Standardgruppe oder einer anderen bestimmten Kalendergruppe ab.
Create Kalender Erstellen Sie einen neuen Kalender in der Standardkalendergruppe oder in der angegebenen Kalendergruppe für einen Benutzer.
Get 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.
Update 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.
Löschen Keine Dient zum Löschen des Kalenderobjekts aktualisieren.
Endgültig löschen Keine Löschen Sie den Kalenderordner endgültig, und entfernen Sie ihn aus dem Postfach.
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.
Frei-/Gebucht-Zeitplan abrufen 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.
Erweiterte mehrwertige Eigenschaft erstellen Kalender Dient zum Erstellen einer oder mehrerer erweiterter mehrwertiger Eigenschaften in einem neuen oder vorhandenen Kalender.
Erweiterte mehrwertige Eigenschaft abrufen 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
calendarGroupId Zeichenfolge Das calendarGroup-Objekt, in dem der Kalender erstellt werden soll. Wenn der Benutzer noch nie explizit eine Gruppe für den Kalender festgelegt hat, ist diese Eigenschaft NULL.
canEdit Boolesch true, wenn der Benutzer in den Kalender schreiben kann, andernfalls false. Diese Eigenschaft ist true für den Benutzer, der den Kalender erstellt hat. Diese Eigenschaft ist auch true für einen Benutzer, dem ein Kalender freigegeben und Schreibzugriff gewährt wurde, über einen Outlook-Client oder die entsprechende calendarPermission-Ressource. Schreibgeschützt.
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. Schreibgeschützt.
canViewPrivateItems Boolean true, wenn der Benutzer Kalendereinträge lesen kann, die als privat markiert wurden, andernfalls false. Diese Eigenschaft wird über einen Outlook-Client oder die entsprechende calendarPermission-Ressource festgelegt. Schreibgeschützt.
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.
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.
isShared Boolescher Wert true, wenn der Benutzer den Kalender für andere Benutzer freigegeben hat, andernfalls false. Da nur der Benutzer, der den Kalender erstellt hat, ihn freigeben kann, können isShared und isSharedWithMe nicht true für denselben Benutzer sein. 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. Schreibgeschützt.
isSharedWithMe Boolescher Wert true, wenn der Benutzer diesen Kalender freigegeben hat, andernfalls false. Diese Immobilie ist für einen Kalenderbesitzer immer false. 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. Schreibgeschützt.
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. Schreibgeschützt.

Beziehungen

Beziehung Typ Beschreibung
calendarPermissions calendarPermission-Sammlung Die Berechtigungen der Benutzer, für die der Kalender freigegeben ist.
calendarView event-Sammlung Die Kalenderansicht für den Kalender. Navigationseigenschaft. Schreibgeschützt.
events event-Sammlung 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 veranschaulicht 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",
  "isShared": "boolean",
  "isSharedWithMe": "boolean",
  "isTallyingResponses": "boolean",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}
}