Create Permission

Create a permission for a file in Google Drive.

Options

Field Definition Type Required

Shared Drive?

Field	Definition	Type	Required
Shared Drive?	Choose from `Yes` or `No`. If `Yes`: actions with files and folders are performed from a shared drive Owner is not shown in the Permission Role dropdown If `No`, actions with files and folders are performed from My Drive.	Dropdown	TRUE
Permission Type	Type of user, group, domain, or Google Drive user who can interact with the specified document. Here are the available options: `User` `Group` `Domain` `Anyone`	Dropdown	TRUE
Permission Role	Level of permissions the `User`, `Group`, `Domain` or `Anyone` can have with the specified document. Here are the available options: `Owner` `Can Edit` `Can Comment` `Can View`	Dropdown	TRUE

Choose from Yes or No.

If Yes:

If No, actions with files and folders are performed from My Drive.

Dropdown

TRUE

Permission Type

Type of user, group, domain, or Google Drive user who can interact with the specified document. Here are the available options:

Dropdown

TRUE

Permission Role

Level of permissions the User, Group, Domain or Anyone can have with the specified document. Here are the available options:

Dropdown

TRUE

Additional Shared Drive information

When users share from Google Drive, they can control whether people can edit, comment on, or only view the file.

Viewer: People can view, but can't change or share the file with others, or delete files.
Commenter: People can add comments and suggestions, but can't change files, share files with others, or delete files.
Editor: People can make changes, accept or reject suggestions, share files with others, and version files. They can't delete files.

File can be deleted by owner of a shared drive. Learn about how to share files from Google Drive here.

Performing operations on shared drives can cause delays if a user has multiple shared drives. Learn about shared drive file and folder limits here.

Field	Definition	Type	Required
File
File ID	Unique ID of the file for which you want to create the specific permissions.	String	TRUE
Permission
Email Address	Email address of the individual for whom permissions are created.	String	TRUE
Email Message	A custom message to include in notification emails about the permissions and document that were shared.	String	FALSE
Transfer Ownership	Indicates whether changing a role to `Owner` downgrades the current owners to writers. Does nothing if the specified role is not `Owner`. Default is `false`.	Boolean	FALSE
Allow File Discovery	Indicates whether the file will be discoverable or not.	Boolean	FALSE
Domain	User's domain.	String	FALSE

Field	Definition	Type
Permission ID	Current user's ID as visible in the permissions collection.	String
Share Link	URL directly to the link that will pull up the file inside Google Drive, but is the share link for the user or group shared to the file with the permission set.	String