upload_group_file（已移除）

已移除

该 API 已移除，暂不支持调用。调用将返回 API_REMOVED；下方保留原参数与响应说明供查阅。

将本地文件或可下载的 HTTP(S) 文件真实上传到群文件。上传完成后，文件会直接出现在 QQ 群文件列表中。

此接口在已认证的服务连接中调用，账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。

file 使用允许的文件来源或本服务 file_transfer 完成引用，name 指定显示文件名。folder_id 省略为根目录。upload_file 只能省略或传 true，false 会被拒绝。

本地文件只可从管理员允许的媒体目录读取；不允许任意读取框架数据、密钥或系统文件。也可使用本服务的 file_transfer 已完成上传引用。

适用协议

Android（手机 / 平板）；Linux QQ 支持情况待核验。

调用方式

向已认证的 WebSocket 连接发送：

json

{
  "type": "action",
  "id": "example-1",
  "action": "upload_group_file",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "group_id": 987654321,
    "file": "data/media-downloads/example.png",
    "name": "example.png"
  }
}

响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。

参数

参数	类型	必填	说明
`self_id`	`integer`	是	当前框架内的账号 QQ 号
`protocol_id`	`integer`	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
`group_id`	`integer`	是	目标群号
`file`	`string`	是	文件来源；受媒体目录权限约束，可使用 transfer:// 引用
`name`	`string`	是	上传后显示的文件名
`folder_id`	`string`	否	群文件目录 ID，根目录为 /
`upload_file`	`boolean`	否	是否执行文件上传，默认 true

返回值

以下为成功响应的 data，错误通过 ok: false 与 error 返回。

字段	类型	说明
`file_id`	`string`	上传接口返回的文件标识
`file_name`	`string`	文件名
`busid`	`integer`	群文件业务 ID，可从文件列表获取
`file_size`	`integer`	文件大小（字节）
`parent_folder_id`	`string`	父目录 ID

upload_group_file（已移除） ​

调用方式 ​

参数 ​

返回值 ​

upload_group_file（已移除）

调用方式

参数

返回值