修改文件信息
... 2026-2-4 大约 1 分钟
# 修改文件信息
# 接口说明
修改指定文件的信息和状态。
# 请求格式
| 描述 | 定义 |
|---|---|
| Path | /openapi/drive/v3/files/{fileId} |
| Method | PATCH |
| Content-Type | application/json; charset=utf-8 |
# 请求头部
详见Headers。
# 请求参数
# 路径参数
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| fileId | string | 是 | 文件 Id，文件的唯一标识 |
# 请求体
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| name | string | 否 | 文件名，即文件列表上的名称 |
| star | bool | 否 | 是否收藏 |
| top | bool | 否 | 是否置顶 |
# 请求示例
curl --location --request PATCH 'https://{domain}/openapi/drive/v3/files/DQVRkTllNZ1pyeHhY' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--data '{
"name":"A**K",
"star":true,
"top":true
}'
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 响应参数
# 响应体
接口请求成功则会返回文件信息(FileInfo)。
# 响应示例
{
"meta": {
"id": "DQVRkTllNZ1pyeHhY",
"parentId": "AKRkHDDwaaBW",
"name": "A**K",
"type": "SHEET",
"ext": "tencentsheet",
"status": "NORMAL",
"url": "https://{domain}/sheet/DQVRkTllNZ1pyeHhY",
"icon": "https://{domain}/private_cdn/tim/docs/docs-design-resources/mobile/png@3x/file_sheet_64@3x-28f87b2076.png",
"creator": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"createTime": "1684911713923",
"owner": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"lastModifyingUser": {
"id": "1022447688093794304",
"type": "OAUTH_USER",
"displayName": "admin",
"avatar": "https://{domain}/eid/avatar/1022447687854718976/6/c8537b8448694c8dbcc2e42e2924c419.gif",
"me": true
},
"modifiedTime": "1684915277650",
"accessTime": "1684913497825",
"isFolder": false,
"isLink": false
},
"entry": {
"sourceParentId": "AKRkHDDwaaBW",
"deleteTime": "1684913484004",
"isTop": true,
"topTime": "1684915313266",
"isStar": true,
"starTime": "1684915313266"
}
}
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
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
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
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