Skip to content

Google: Updates an access control rule — request body — body

Updates an access control rule.: request body, field body. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Updates an access control rule — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
etagstringOptionalETag of the resource.
idstringOptionalIdentifier of the Access Control List (ACL) rule. See Sharing calendars.
kindstringOptionalType of the resource (“calendar#aclRule”).
Default: calendar#aclRule
rolestringOptionalThe 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.
- “writerWithoutPrivateAccess” - Provides read and write access to the calendar. Private events will appear to users with writerWithoutPrivateAccess 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 manager access to the calendar. This role has all of the permissions of the writer role with the additional ability to modify access levels of other users.
Important: the owner role is different from the calendar’s data owner. A calendar has a single data owner, but can have multiple users with owner role.
scopeModelRequired within parentExpand Creates an access control rule — response body — scope

Referenced models: Creates an access control rule — response body — scope

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.