Acl: update
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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 Methode calendarList.list auf, um Kalender-IDs abzurufen. Wenn Sie auf den primären Kalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie das Keyword „primary“.
|
ruleId |
string |
ACL-Regel-ID.
|
| Optionale Suchparameter |
sendNotifications |
boolean |
Ob Benachrichtigungen über die Änderung der Kalenderfreigabe gesendet werden sollen. Es werden keine Benachrichtigungen zum Entfernen des Zugriffs gesendet. Optional. Der Standardwert ist „True“.
|
Autorisierung
Diese Anfrage erfordert eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
| 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 Properties |
scope |
object |
Der Umfang, in dem Kalenderzugriff durch diese ACL-Regel gewährt wird. |
|
scope.type |
string |
Der Typ des Gültigkeitsbereichs. Mögliche Werte sind: - „
default“ – öffentlicher Bereich. „Immer“ ist der Standardwert. - „
user“: Der Umfang wird auf einen einzelnen Nutzer beschränkt. - „
group“: Der Umfang wird auf eine Gruppe beschränkt. - „
domain“: Der Umfang wird auf eine Domain beschränkt. Hinweis: Die Berechtigungen, die dem Bereich „default“ (öffentlich) gewährt wurden, gelten für alle Nutzer, unabhängig davon, ob sie authentifiziert sind oder nicht. |
|
| Optionale Eigenschaften |
role |
string |
Die Rolle, die dem Umfang zugewiesen ist. Mögliche Werte sind: - „
none“: Bietet keinen Zugriff. - „
freeBusyReader“: Bietet Lesezugriff auf Informationen zur Verfügbarkeit. - „
reader“: Bietet Lesezugriff auf den Kalender. Private Termine werden Nutzern mit Lesezugriff angezeigt, Termindetails werden jedoch ausgeblendet. - „
writer“: Gewährt Lese- und Schreibzugriff auf den Kalender. Private Termine werden Nutzern mit Schreibzugriff angezeigt und die Termindetails sind sichtbar. Gewährt Lesezugriff auf die ACLs des Kalenders. - „
owner“: Gibt die Inhaberschaft des Kalenders an. Diese Rolle hat alle Berechtigungen der Rolle „Bearbeiter“ und zusätzlich die Möglichkeit, ACLs zu manipulieren. |
Bearbeitbar
|
scope.value |
string |
Die E-Mail-Adresse eines Nutzers oder einer Gruppe oder der Name einer Domain, je nach Umfang. Für den Typ „default“ wird dieser Wert nicht berücksichtigt. |
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.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# Acl: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates an access control rule.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|---------------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier. To retrieve calendar IDs call the [calendarList.list](/workspace/calendar/api/v3/reference/calendarList/list) method. If you want to access the primary calendar of the currently logged in user, use the \"`primary`\" keyword. |\n| `ruleId` | `string` | ACL rule identifier. |\n| **Optional query parameters** |||\n| `sendNotifications` | `boolean` | Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|-------------------------------------------------|\n| `https://www.googleapis.com/auth/calendar` |\n| `https://www.googleapis.com/auth/calendar.acls` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nIn the request body, supply an [Acl resource](/workspace/calendar/api/v3/reference/acl#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| **Required Properties** ||||\n| `scope` | `object` | The extent to which [calendar access](https://developers.google.com/workspace/calendar/concepts/sharing#sharing_calendars) is granted by this ACL rule. | |\n| scope.`type` | `string` | The type of the scope. Possible values are: - \"`default`\" - The public scope. This is the default value. - \"`user`\" - Limits the scope to a single user. - \"`group`\" - Limits the scope to a group. - \"`domain`\" - Limits the scope to a domain. Note: The permissions granted to the \"`default`\", or public, scope apply to any user, authenticated or not. | |\n| **Optional Properties** ||||\n| `role` | `string` | The role assigned to the scope. Possible values are: - \"`none`\" - Provides no access. - \"`freeBusyReader`\" - Provides read access to free/busy information. - \"`reader`\" - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden. - \"`writer`\" - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible. Provides read access to the calendar's ACLs. - \"`owner`\" - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to manipulate ACLs. | writable |\n| scope.`value` | `string` | The email address of a user or group, or the name of a domain, depending on the scope type. Omitted for type \"`default`\". | writable |\n\nResponse\n--------\n\nIf successful, this method returns an [Acl resource](/workspace/calendar/api/v3/reference/acl#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
