Insert

Creates an access control rule

9 variables
7 variables

Creates an access control rule

Authorization

To use this building block you will have to grant access to at least one of the following scopes:

  • See, edit, share, and permanently delete all the calendars you can access using Google Calendar

Input

This building block consumes 9 input parameters

  = Parameter name
  = Format

calendarId STRING 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

sendNotifications BOOLEAN

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

etag STRING

ETag of the resource

id STRING

Identifier of the ACL rule

kind STRING

Type of the resource ("calendar#aclRule")

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.
  • "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.

scope OBJECT

The scope of the rule

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.

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"

Output

This building block provides 7 output parameters

  = Parameter name
  = Format

etag STRING

ETag of the resource

id STRING

Identifier of the ACL rule

kind STRING

Type of the resource ("calendar#aclRule")

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.
  • "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.

scope OBJECT

The scope of the rule

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.

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"