批量修改文件元信息
适用版本>=v7.0.2512.20251225
接口说明：批量修改文件元信息
请求说明
| 请求地址 | 配置域名+/openapi+/v7/appfiles/drives/{drive_id}/files/batch_update |
|---|---|
| 请求方法 | POST |
| 签名方式 | KSO-1（配置域名+/openapi不参与签名） |
| 权限要求 | 应用身份管理文档（应用授权） kso.appfiles.readwrite |
请求头（Header）
| Header | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| X-Kso-Date | string | 是 | RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT |
| X-Kso-Authorization | string | 是 | KSO-1 签名值，详见《签名方法》 |
| Authorization | string | 是 | 授权凭证，格式为：Bearer {access_token} |
路径参数（Path）
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| drive_id | string | 是 | 驱动盘id |
查询参数（Query）
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| _w_third_user_id | string | 否 | 操作者id |
请求体（Body）
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| file_ids | []string | 是 | 文件 ID 列表 |
| owner_id | string | 否 | 被转让者 ID |
请求体示例
json
{
"file_ids": [
"1234567890",
"1234567891"
],
"owner_id": "user_987654321"
}响应体（Response）
| 名称 | 类型 | 说明 |
|---|---|---|
| data | object | 返回的数据对象 |
| ∟ items | array | 文件信息列表 |
| ∟∟ id | string | 文件 ID |
| ∟∟ drive_id | string | 驱动盘 ID |
| ∟∟ parent_id | string | 父目录 ID（应用文档：0） |
| ∟∟ created_by | object | 创建者信息 |
| ∟∟∟ id | string | 身份 ID |
| ∟∟∟ type | string | Enum: "sp" |
| ∟∟ modified_by | object | 修改者信息 |
| ∟∟∟ id | string | 身份 ID |
| ∟∟∟ type | string | Enum: "sp" |
| ∟∟ size | integer | 文件大小（字节） |
| ∟∟ version | integer | 文件版本号 |
| ∟∟ type | string | 文件类型 Enum: "folder" / "file" |
| ∟∟ name | string | 文件名称 |
| ∟∟ ctime | integer | 创建时间（Unix 时间戳） |
| ∟∟ mtime | integer | 修改时间（Unix 时间戳） |
| ∟∟ shared | boolean | 是否开启分享 |
| ∟∟ link_url | string | 链接 URL |
| ∟∟ link_id | string | 链接 ID |
| code | int | 错误码 |
| msg | string | 状态信息 |
| detail | string | 详细信息 |
响应体示例
json
{
"data": {
"items": [
{
"id": "349089648689152",
"drive_id": "349087249465344",
"parent_id": "0",
"created_by": {
"id": "id1",
"type": "sp"
},
"modified_by": {
"id": "id2",
"type": "sp"
},
"size": 14498,
"version": 2,
"type": "file",
"name": "应用文档测试文件.otl",
"ctime": 1764138916,
"mtime": 1764922280,
"shared": false,
"link_url": "",
"link_id": ""
}
]
},
"code": 0,
"detail": "",
"msg": "ok"
}