All Products
Search
Document Center

Drive and Photo Service:FilePermissionMember

Last Updated:Aug 28, 2026

Parameter

Type

Description

Example

object

The file permission details for a member.

identity Identity

The authorized identity, which can be a user or a group.

role_id

string

The role ID. Permissions can be granted by role or by custom action list. This parameter is mutually exclusive with action_list. If both are specified, role_id takes precedence.

Valid values:

SystemFileOwner: collaborator

SystemFileDownloader: downloader

SystemFileEditor: editor

SystemFileEditorWithoutDelete: editor without delete permissions

SystemFileEditorWithoutShareLink: editor without share permissions

SystemFileMetaViewer: viewer of lists

SystemFileUploader: uploader. SystemFileUploaderAndDownloader: uploader and downloader

SystemFileDownloaderWithShareLink: downloader and sharer

SystemFileUploaderAndDownloaderWithShareLink: uploader, downloader, and sharer

SystemFileUploaderAndViewer: viewer and uploader

SystemFileUploaderWithShareLink: uploader and sharer

SystemFileViewer: viewer

SystemFileDownloader

expire_time

integer

The expiration time of the permissions, in milliseconds since January 1, 1970, 00:00:00 UTC. A value of 4775500800000 indicates that the permissions never expire.

1633598085642

disinherit_sub_group

boolean

Specifies whether subgroup members can inherit the permissions. For example, user1 belongs to group1, and user2 belongs to group2, which is a subgroup of group1. If disinherit_sub_group is set to true, only user1 is granted the permissions. user2 is not granted the permissions.

false

action_list

array

The custom permissions to grant. This parameter is mutually exclusive with role_id. If both are specified, role_id takes precedence. When you specify action_list, the system automatically generates a temporary role_id that you can use to revoke the permissions.

string

The permission. Valid values:

  • FILE.VISIBLE

  • FILE.PREVIEW

  • FILE.MOVE

  • FILE.DELETE

  • FILE.COPY

  • FILE.CREATE

  • FILE.DOWNLOAD

  • FILE.SHARELINK

  • FILE.UPDATE

  • FILE.LIST

FILE.CREATE