calendarPermission-Ressourcentyp

Namespace: microsoft.graph

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.

Beim Abrufen der Kalenderberechtigungen eines Kalenders im Namen eines Empfängers oder Delegaten wird eine leere Sammlung von Kalenderberechtigungen zurückgegeben.

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

Methoden

Methode	Rückgabetyp	Beschreibung
List	calendarPermission	Rufen Sie eine Auflistung von calendarPermission-Objekten ab, die die Identität und die Rollen von Benutzern beschreiben, für die der angegebene Kalender freigegeben oder delegiert wurde.
Create	calendarPermission	Erstellen Sie das calendarPermission-Objekt.
calendarPermission abrufen	calendarPermission	Lesen von Eigenschaften und Beziehungen des calendarPermission-Objekts.
Update	calendarPermission	Aktualisieren des calendarPermission-Objekts.
Delete	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 -delegaten dar, der Zugriff auf den Kalender hat. Für den Empfänger der Freigabe "Meine Organisation" ist die Address-Eigenschaft NULL. Schreibgeschützt.
id	String	Der eindeutige Bezeichner des Benutzers (Empfänger oder Stellvertretung), für den der Kalender freigegeben wurde. Schreibgeschützt.
isInsideOrganization	Boolesch	True, wenn sich der Benutzer im Kontext (Empfänger oder Delegat) innerhalb desselben organization wie der Kalenderbesitzer befindet.
isRemovable	Boolesch	True , wenn der Benutzer aus der Liste der Empfänger oder Stellvertretungen für den angegebenen Kalender entfernt werden kann, false andernfalls. Der Benutzer "My organization" bestimmt die Berechtigungen, die andere Personen in Ihrem organization für den angegebenen Kalender haben. Sie können "My organization" 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 Empfänger, der Frei/Gebucht-status des Besitzers im Kalender anzeigen kann.
limitedRead	Der Benutzer ist ein Empfänger, der Frei/Gebucht-status sowie Titel und Speicherorte der Ereignisse im Kalender anzeigen kann.
Lesen	Der Benutzer ist ein Empfänger, der alle Details der Ereignisse im Kalender mit Ausnahme der privaten Ereignisse des Besitzers anzeigen kann.
Schreiben	Der Benutzer ist ein Empfänger, der alle Details (mit Ausnahme privater Ereignisse) anzeigen und Ereignisse im Kalender bearbeiten kann.
delegateWithoutPrivateEventAccess	Der Benutzer ist ein Delegat, der über Schreibzugriff verfügt, aber keine Informationen zu den privaten Ereignissen des Besitzers im Kalender anzeigen kann.
delegateWithPrivateEventAccess	Der Benutzer ist ein Delegat, der über Schreibzugriff verfügt 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

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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