get_group_history_messages

读取指定序号范围的普通群历史消息，按序号升序返回。

适用协议

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

调用方式

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

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
group_id	integer	是	目标群号
begin_seq	integer	否	包含起始序号，默认 0。
end_seq	integer	否	包含结束序号，默认 0。

begin_seq、end_seq 省略或都为 0 时，读取最新 20 个序号范围；返回条数由 QQ 决定。指定范围时，两者都必须为正整数且 begin_seq <= end_seq，不使用旧接口的 count 或 message_seq。有效空记录返回成功；空包、QQ 拒绝、响应群号不符和解析失败返回错误。本接口不触发实时消息事件，不增加收信计数。

返回值

字段	类型	说明
group_id	integer	目标群号
begin_seq	integer	服务端返回的起始序号
end_seq	integer	服务端返回的结束序号
messages	object[]	按 msg.seq 升序排列，每条包含 msg、sender、message、alt_message
all_msg_filtered	integer	上游返回的消息过滤状态原值；可选字段
share_history_msg_flag	integer	上游返回的历史消息分享状态原值；可选字段

msg 包含十进制字符串 uid 和整数 seq、random、time。发送者未知时 sender.user_id 为 0；名片为空则省略。图片包含 file_id 和 url，语音及视频仅包含 file_id。

两个状态字段仅在上游提供时返回，保留原始 int32 数值；显式 0 不省略，缺失时不补默认值。