calendarPermission-Ressourcentyp

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.

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 Freigabeempfä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 Freigabeempfä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 Freigabeempfä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	Create calendarPermission-Objekt.
Get	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	Zeichenfolge	Der eindeutige Bezeichner des Benutzers (Freigabeempfänger oder Stellvertretung), für den der Kalender freigegeben wurde. Schreibgeschützt.
isInsideOrganization	Boolesch	True, wenn sich der Benutzer im Kontext (Freigabeempfä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 "Meine organization" als Empfänger nicht in 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 Frei/Gebucht-status des Besitzers im Kalender anzeigen kann.
limitedRead	Der Benutzer ist ein Freigabeempfänger, der Frei/Gebucht-status sowie Titel und Speicherorte 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 ü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"
}