get_group_files

使用指定 Android 或 Linux QQ 在线会话获取群文件根目录。接口会自动处理 QQ 服务端分页，并分别返回文件与文件夹。

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

不传 folder_id 或传 / 时读取根目录；否则读取指定文件夹。file_count 默认 50。files 与 folders 分别返回文件和目录。

适用协议

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

调用方式

向已认证的 WebSocket 连接发送：

json

{
  "type": "action",
  "id": "example-1",
  "action": "get_group_files",
  "params": {
    "self_id": 123456789,
    "protocol_id": 0,
    "group_id": 987654321
  }
}

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

参数

参数	类型	必填	说明
`self_id`	`integer`	是	当前框架内的账号 QQ 号
`protocol_id`	`integer`	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
`group_id`	`integer`	是	目标群号
`folder_id`	`string`	否	群文件目录 ID，根目录为 /
`file_count`	`integer`	否	文件数量 / 列表读取数量

返回值

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

字段	类型	说明
`files`	`array`	文件列表
`files[].group_id`	`integer`	目标群号
`files[].file_id`	`string`	上传接口返回的文件标识
`files[].file_name`	`string`	文件名
`files[].busid`	`integer`	群文件业务 ID，可从文件列表获取
`files[].file_size`	`integer`	文件大小（字节）
`files[].upload_time`	`integer`	上传时间
`files[].dead_time`	`integer`	文件到期时间
`files[].modify_time`	`integer`	最后修改时间
`files[].download_times`	`integer`	下载次数
`files[].uploader`	`integer`	上传者信息
`files[].uploader_name`	`string`	上传者昵称
`files[].parent_folder_id`	`string`	父目录 ID
`folders`	`array`	目录列表
`folders[].group_id`	`integer`	目标群号
`folders[].folder_id`	`string`	群文件目录 ID，根目录为 /
`folders[].parent_folder_id`	`string`	父目录 ID
`folders[].folder_name`	`string`	目录名称
`folders[].create_time`	`integer`	创建时间
`folders[].modify_time`	`integer`	最后修改时间
`folders[].creator`	`integer`	创建者信息
`folders[].creator_name`	`string`	创建者昵称
`folders[].total_file_count`	`integer`	目录内文件数量

get_group_files ​

调用方式 ​

参数 ​

返回值 ​

get_group_files

调用方式

参数

返回值