Google Drive action - Add file permission

This action adds a permission to a particular file in Google Drive. Permissions are useful to transfer file ownership or to share a file with specific users, groups, or domains, or to make it accessible to anyone.

Google Drive Add file permission action

Input fields

Field name	Description
File	The file you plan to add permission to. Select a file or enter its ID. To find the file ID, right-click the file and select Share > Copy link. For example, if the URL is https://drive.google.com/file/d/123nyR2IjW_Rq84d3qEYRoq1/view, the file ID is 123nyR2IjW_Rq84d3qEYRoq1. Alternatively, you can find the file ID in the output of other Google Drive triggers and actions.
Role	The role granted by this permission. Select a role or use a custom value. Allowed values: owner, organizer, fileOrganizer, writer, commenter, reader.
Share with	Who to grant the permission to. Select an entity or use a custom value. If this is set to a user or group, you must provide their email address. If it is set to a domain, you must provide a domain. Allowed values: user, group, domain, anyone.
Email address	Email address of the specific user or group the permission refers to. Required if Share with is set to user or group.
Domain	Domain the permission refers to. Required if Share with is set to domain.
Allow file discovery?	Determines if a file can be discovered through search. This is only applicable to permissions granted to domain or anyone. Defaults to Yes.
Send notifications	Determines if a notification is sent to a user or group about the permission. Not applicable if the file is shared to domain or anyone. Defaults to Yes for users and groups.
Notification message	A plain text custom message to include in the notification email.
Transfer ownership	Transfer ownership of the file to the user provided. Requires Share with to be set to user and Role to be set as owner. Defaults to No.
Move file to root of the user	Moves the file to the new owner's root folder. Requires Transfer ownership to be set to Yes. Defaults to No.
Use domain admin access?	Issues the request as a domain administrator, if the connected user is the admin of the domain owning a shared drive. This setting allows the domain admin to set permissions for shared drive files (opens new window) owned by their domain even if they aren't a member of the given shared drive. Default is set to No.

Output fields

Kind

The kind of resource this is: drive#permission.

Type

The type of grantee: user, group, domain, or anyone.

Permission ID

The ID of this permission.

Email address

The email address of the user or group that was granted this permission.

Domain

The domain this permission refers to.

Role

The role granted by this permission.

View

The view for this permission.

Allow file discovery

Whether this permission allows the file to be discovered through search. This is only applicable to permissions granted to domain or anyone.

Display name

The human-readable name for the permission grantee. user: User's full name. group: Name of the Google Group. Domain: Domain owning the shared drive. Not applicable to the type anyone.

Photo link

A link to the user's profile photo, if available.

Team Drive permission details

A list of permission details for the Team Drive. Contains the following output fields, in addition to List size and List index:

Team Drive permission type

The permission type for this user. Team Drives only.

Role

The primary role for this user. Team Drives only.

Inherited from

The ID of the item from which this permission is inherited. Team Drives only.

Inherited

Whether this permission is inherited. Team Drives only.

Permission details

A list of permission details for the shared drive. Contains the following output fields, in addition to List size and List index:

Permission type

The permission type for this user. Shared drives only.

Role

The primary role for this user. Shared drives only.

Inherited from

The ID of the item from which this permission is inherited. Shared drives only.

Inherited

Whether this permission is inherited. Shared drives only.

Deleted

Whether the account associated with this permission has been deleted. This field only applies to user and group permissions.