calendarPermission-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Die Berechtigungen eines Benutzers, für den der Kalender in einem Outlook Client freigegeben oder delegiert wurde.

Das Auflisten, Erstellen, Abrufen, Aktualisieren und Löschen von Kalenderberechtigungen wird nur im Namen des Kalenderbesitzers unterstützt.

Wenn Sie die Kalenderberechtigungen eines Kalenders im Auftrag eines Freigabeempfängers oder Stellvertreters abrufen, wird eine leere Kalenderberechtigungssammlung zurückgegeben.

Nachdem ein Freigabeempfänger oder Stellvertretung für einen Kalender eingerichtet wurde, können Sie nur die Rolleneigenschaft aktualisieren, um die Berechtigungen eines Freigabeempfängers oder Delegaten zu ändern. Sie können die Eigenschaft allowedRoles, emailAddress, isInsideOrganization oder isRemovable nicht aktualisieren. Um diese Eigenschaften zu ändern, sollten Sie das entsprechende calendarPermission-Objekt löschen und einen weiteren Freigabeempfänger oder Delegaten in einem Outlook-Client erstellen.

Methoden

Methode	Rückgabetyp	Beschreibung
List	calendarPermission	Dient zum Abrufen einer Auflistung von calendarPermission -Objekten, die die Identität und Rollen von Benutzern beschreiben, für die der angegebene Kalender freigegeben oder delegiert wurde.
Create	calendarPermission	Dient zum Erstellen eines calendarPermission-Objekts.
calendarPermission abrufen	calendarPermission	Dient zum Lesen der Eigenschaften und der Beziehungen des calendarPermission-Objekts.
Update	calendarPermission	Dient zum Aktualisieren des calendarPermission-Objekts.
Löschen	Keine	Dient zum Löschen des calendarPermission-Objekts.

Eigenschaften

Eigenschaft	Typ	Beschreibung
allowedRoles	calendarRoleType-Auflistung	Liste der zulässigen Freigabe- oder Delegierungsberechtigungsstufen für den Kalender. Mögliche Werte: none, freeBusyRead, limitedRead, read, write, delegateWithoutPrivateEventAccess, delegateWithPrivateEventAccess, custom.
emailAddress	emailAddress	Stellt einen Freigabeempfänger oder Stellvertreter dar, der Zugriff auf den Kalender hat. Für den Freigabeempfänger "Meine Organisation" ist die Adresseigenschaft NULL. Schreibgeschützt.
id	Zeichenfolge	Der eindeutige Bezeichner des Benutzers (Freigabeempfänger oder Stellvertreter), für den der Kalender freigegeben wurde. Schreibgeschützt.
isInsideOrganization	Boolesch	True, wenn sich der Benutzer im Kontext (Freigabeempfänger oder Stellvertreter) in derselben Organisation wie der Kalenderbesitzer befindet.
isRemovable	Boolesch	True wenn der Benutzer aus der Liste der Freigaben oder Stellvertretungen für den angegebenen Kalender entfernt werden kann, false andernfalls. Der Benutzer "Meine Organisation" bestimmt die Berechtigungen, die andere Personen in Ihrer Organisation für den angegebenen Kalender haben. Sie können "Meine Organisation" nicht als Freigabeempfänger für einen Kalender entfernen.
role	calendarRoleType	Aktuelle Berechtigungsstufe des Kalenderfreigabeempfängers oder -delegaten.

calendarRoleType-Werte

Member	Beschreibung
Keine	Der Kalender wird nicht für den Benutzer freigegeben.
freeBusyRead	Der Benutzer ist ein Freigabeempfänger, der den Frei/Gebucht-Status des Besitzers im Kalender anzeigen kann.
limitedRead	Der Benutzer ist ein Freigabeempfänger, der den Frei/Gebucht-Status sowie Titel und Orte der Ereignisse im Kalender anzeigen kann.
Lesen	Der Benutzer ist ein Freigabeempfänger, der alle Details der Ereignisse im Kalender anzeigen kann, mit Ausnahme der privaten Ereignisse des Besitzers.
Schreiben	Der Benutzer ist ein Freigabeempfänger, der alle Details (mit Ausnahme privater Ereignisse) anzeigen und Ereignisse im Kalender bearbeiten kann.
delegateWithoutPrivateEventAccess	Der Benutzer ist ein Delegat, der Schreibzugriff hat, aber keine Informationen zu den privaten Ereignissen des Besitzers im Kalender anzeigen kann.
delegateWithPrivateEventAccess	Der Benutzer ist ein Delegat, der Schreibzugriff hat und Informationen zu den privaten Ereignissen des Besitzers im Kalender anzeigen kann.
Benutzerdefinierte	Der Benutzer verfügt über benutzerdefinierte Berechtigungen für den Kalender.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "allowedRoles": ["string"],
  "emailAddress": {"@odata.type": "microsoft.graph.emailAddress"},
  "id": "String (identifier)",
  "isInsideOrganization": "boolean",
  "isRemovable": "boolean",
  "role": "string"
}