Freigeben über


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 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 (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"
}