更新文件权限
... 2026-2-4 大约 2 分钟
# 更新文件权限
# 接口说明
本接口用于更新文档、共享文件夹、空间权限。
- 如需修改存量协作者的权限,应先
deleteMembers再addMembers。
# 请求格式
| 描述 | 定义 |
|---|---|
| Path | /openapi/drive/v3/files/{fileId}/permissions |
| Method | PATCH |
| Content-Type | application/json; charset=utf-8 |
# 请求头部
详见Headers。
# 请求参数
# 路径参数
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| fileId | string | 是 | 文件 Id，文件的唯一标识 |
# 请求体
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| permission | object(Permission) | 否 | 权限设置 |
| addMembers | array(Member) | 否 | 增加协作者(一批最多支持50人) |
| deleteMembers | array(Member) | 否 | 删除协作者(一批最多支持50人) |
# Member
添加/删除成员入参
| 字段 | 描述 |
|---|---|
| id | 用户 Id，不同类型用户的 Id 也不相同 |
| type | 用户类型 |
# 请求示例
curl --location --request PATCH 'https://{{domain}}/openapi/drive/v3/files/DQVZOVVRtVmZaa2ds/permissions' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--header 'Content-Type: application/json' \
--header 'Cookie: TOK=b98ed40e7032383d' \
--data-raw '{
"permission": {
"accessPolicy": "REVIEWED_BY_ADMIN",
"externalAccessPolicy": "PRIVATE",
"spaceSetting": {
"confidentialMode": true,
"defaultViewRange": "EXTERNAL_CORPORATION",
"onlyAdminCanManage": false,
"externalAccess": true,
"canInviteByLinks": true
},
"members": [
{
"user": {
"id": "1304385698106703884",
"type": "OAUTH_USER"
},
"role": "EDITOR",
"actions": [
"EDIT"
]
}
]
},
"addMembers": [
{
"user": {
"id": "1285519506428396663",
"type": "OAUTH_USER"
},
"role": "CUSTOMIZED_ROLE",
"actions": [
"EDIT_FOLDER"
]
}
],
"deleteMembers": [
{
"user": {
"id": "1285519506428396666",
"type": "OAUTH_USER"
},
"role": "CUSTOMIZED_ROLE",
"actions": [
"EDIT_FOLDER"
]
}
]
}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# 响应参数
# 响应体
接口请求成功则会返回文件权限设置(Permission)。
# 响应示例
{
"accessPolicy": "REVIEWED_BY_ADMIN",
"externalAccessPolicy": "PRIVATE",
"members": [
{
"user": {
"id": "user1",
"type": "OAUTH_USER",
"displayName": "user1Name",
"avatar": "http://test1.png"
},
"role": "SUPER_ADMIN"
},
{
"user": {
"id": "user2",
"type": "OAUTH_USER",
"displayName": "user2Name",
"avatar": "http://test2.svg"
},
"role": "VIEWER"
},
{
"user": {
"id": "user3",
"type": "OAUTH_USER",
"displayName": "user3Name",
"avatar": "http://test3.svg"
},
"role": "VIEWER"
}
],
"setting": {
"confidentialMode": true,
"defaultViewRange": "EXTERNAL_CORPORATION",
"onlyAdminCanManage": false,
"externalAccess": true,
"canInviteByLinks": true
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40