get_group_notice

获取指定群聊的公告列表。

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

适用协议

Android（手机 / 平板）/ Linux QQ；需要当前账号具备有效的 SKey 与 qun.qq.com PsKey。

调用方式

向已认证的 WebSocket 连接发送：

{
  "type": "action",
  "id": "example-1",
  "action": "get_group_notice",
  "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	是	目标群号

返回值

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

data 为数组，下表描述每个元素。

字段	类型	说明
sender_id	integer	发送者 QQ 号
publish_time	integer	公告发布时间
notice_id	string	公告列表返回的公告 ID
message	object	消息段数组，结构见消息段参考
message.text	string	文本内容
message.image	object[]	图片来源或图片元信息
message.image[].id	string	资源标识
message.image[].height	string	像素高度
message.image[].width	string	像素宽度
message.images	object[]	图片来源数组，最多 9 项
message.images[].id	string	资源标识
message.images[].height	string	像素高度
message.images[].width	string	像素宽度
settings	object	公告设置
read_num	integer	公告阅读人数
published_at	integer	公告发布时间
content	string	正文内容
images	object[]	图片来源数组，最多 9 项
images[].id	string	资源标识
images[].height	string	像素高度
images[].width	string	像素宽度
read_count	integer	公告阅读人数