Ressourcentyp calendar
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:
- 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 |
|---|---|---|
| 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"}
}