Create Permission

Create a permission for a file in Google Drive.

Options

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. Options:
  • User
  • Group
  • Domain
  • Anyone
Dropdown TRUE
Permission Role Level of permissions the User, Group, Domain or Anyone can have with the specified document. Options:
  • Owner
  • Can Edit
  • Can Comment
  • Can View
Dropdown TRUE
Note

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.

Input

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

Output

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

Related topics

Google Drive connector

About the elements of Okta Workflows

G Suite API documentation