Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-173040119.6 KB
acl

Creates an access control rule.

post/calendars/{calendarId}/acl

Path parameters

calendarIdstring required

Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword

Query parameters

sendNotificationsboolean

Whether to send notifications about the calendar sharing change. Optional. The default is True

Request body

rolestring

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.
  • "owner" - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to see and manipulate ACLs
kindstring

Type of the resource ("calendar#aclRule")

etagstring

ETag of the resource

idstring

Identifier of the Access Control List (ACL) rule. See Sharing calendars

Response

A gcalendar:AclRule if successful, otherwise an error

rolestring

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.
  • "owner" - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to see and manipulate ACLs
kindstring

Type of the resource ("calendar#aclRule")

etagstring

ETag of the resource

idstring

Identifier of the Access Control List (ACL) rule. See Sharing calendars