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:
- Benutzerkalender können Sie nur in einer CalendarGroup organisieren.
- Outlook akzeptiert automatisch alle Besprechungsanfragen im Auftrag von Gruppen. Sie können Besprechungsanfragen nur für Benutzerkalender annehmen, mit Vorbehalt annehmen oder ablehnen .
- Outlook unterstützt keine Erinnerungen für Gruppenereignisse. Das Erneute Erinnern oder Schließen einer Erinnerung ist nur bei Benutzerkalendern möglich.
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"}
}