Freigeben über


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