Acl: update

Aktualisiert eine Zugriffssteuerungsregel. Jetzt testen.

Anfrage

HTTP-Anfrage

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId

Parameter

Parametername Wert Beschreibung
Pfadparameter
calendarId string Kalender-ID. Rufen Sie die Kalender-IDs mit der Methode calendarList.list ab. Wenn Sie auf den primären Kalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie das Schlüsselwort "primary".
ruleId string ACL-Regel-ID.
Optionale Suchparameter
sendNotifications boolean Gibt an, ob Benachrichtigungen über die Änderung der Kalenderfreigabe gesendet werden sollen. Hinweis: Es gibt keine Benachrichtigungen zum Entfernen des Zugriffs. Optional. Der Standardwert ist „True“.

Autorisierung

Für diese Anfrage ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich:

Umfang
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Geben Sie im Anfragetext eine Acl-Ressource mit den folgenden Eigenschaften an:

Property-Name Wert Beschreibung Hinweise
Erforderliche Attribute
scope object Der Umfang, in dem der Kalenderzugriff durch diese ACL-Regel gewährt wird.
scope.type string Der Typ des Bereichs. Mögliche Werte sind:
  • "default" - Der öffentliche Bereich. „Immer“ ist der Standardwert.
  • "user" \- Beschränkt den Bereich auf einen einzelnen Nutzer.
  • "group" - Beschränkt den Bereich auf eine Gruppe.
  • "domain" \- Beschränkt den Bereich auf eine Domain.
Hinweis: Die Berechtigungen, die dem Bereich "default" oder dem öffentlichen Bereich gewährt werden, gelten für alle Nutzer, unabhängig davon, ob sie authentifiziert sind oder nicht.
Optionale Attribute
role string Die dem Bereich zugewiesene Rolle. Mögliche Werte sind:
  • "none" - Bietet keinen Zugriff.
  • "freeBusyReader" - Bietet Lesezugriff auf Informationen zu Verfügbarkeit.
  • "reader" - Bietet Lesezugriff auf den Kalender. Private Termine werden Nutzern mit Lesezugriff angezeigt, Termindetails sind jedoch nicht verfügbar.
  • "writerWithoutPrivateAccess" - Bietet Lese- und Schreibzugriff auf den Kalender. Private Termine werden Nutzern mit writerWithoutPrivateAccess-Zugriff angezeigt, Termindetails sind jedoch nicht verfügbar.
  • "writer" - Bietet Lese- und Schreibzugriff auf den Kalender. Private Termine werden Nutzern mit Schreibzugriff angezeigt und Termindetails sind sichtbar. Bietet Lesezugriff auf die ACLs des Kalenders.
  • "owner" - Bietet Managerzugriff auf den Kalender. Diese Rolle hat alle Berechtigungen der Rolle „Schreibberechtigter“ und kann zusätzlich die Zugriffsebenen anderer Nutzer ändern.

Bearbeitbar
scope.value string Die E-Mail-Adresse eines Nutzers oder einer Gruppe oder der Name einer Domain, je nach Bereichstyp. Für den Typ "default" ausgelassen. Bearbeitbar

Antwort

Bei Erfolg gibt diese Methode eine Acl-Ressource im Antworttext zurück.

Testen!

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.