get_group_album_media_list

分页获取指定群相册中的图片和视频。

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

适用协议

Android（手机 / 平板）/ Linux QQ。

调用方式

向已认证的 WebSocket 连接发送：

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

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

参数

参数	类型	必填	说明
self_id	integer	是	当前框架内的账号 QQ 号
protocol_id	integer	是	账号协议配置 ID；从 get_protocol_list 获取，必须显式传入，0 也是有效 ID
group_id	integer	是	目标群号
album_id	string	是	相册列表返回的相册 ID
attach_info	string	否	上一页返回的分页游标，首次可省略

返回值

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

字段	类型	说明
album_id	string	相册列表返回的相册 ID
album_owner	string	相册所属账号
album_name	string	相册名称
media_list	object[]	相册媒体列表
media_list[].type	integer	操作类型，见使用说明
media_list[].image	object	图片来源或图片元信息
media_list[].image.name	string	上传后显示的文件名
media_list[].image.sloc	string	图片资源位置标识
media_list[].image.lloc	string	相册媒体列表返回的媒体位置标识
media_list[].image.photo_urls	object[]	不同规格图片地址
media_list[].image.photo_urls[].spec	integer	资源规格标识
media_list[].image.photo_urls[].url	object	资源地址
media_list[].image.photo_urls[].url.url	string	资源地址
media_list[].image.photo_urls[].url.width	integer	像素宽度
media_list[].image.photo_urls[].url.height	integer	像素高度
media_list[].image.default_url	object	默认图片地址及尺寸
media_list[].image.default_url.url	string	资源地址
media_list[].image.default_url.width	integer	像素宽度
media_list[].image.default_url.height	integer	像素高度
media_list[].image.is_gif	boolean	是否为 GIF
media_list[].image.has_raw	boolean	是否有原图
media_list[].video	object	视频信息
media_list[].video.id	string	资源标识
media_list[].video.url	string	资源地址
media_list[].video.cover	object	封面信息
media_list[].video.cover.name	string	上传后显示的文件名
media_list[].video.cover.sloc	string	图片资源位置标识
media_list[].video.cover.lloc	string	相册媒体列表返回的媒体位置标识
media_list[].video.cover.photo_urls	object[]	不同规格图片地址
media_list[].video.cover.photo_urls[].spec	integer	资源规格标识
media_list[].video.cover.photo_urls[].url	object	资源地址
media_list[].video.cover.photo_urls[].url.url	string	资源地址
media_list[].video.cover.photo_urls[].url.width	integer	像素宽度
media_list[].video.cover.photo_urls[].url.height	integer	像素高度
media_list[].video.cover.default_url	object	默认图片地址及尺寸
media_list[].video.cover.default_url.url	string	资源地址
media_list[].video.cover.default_url.width	integer	像素宽度
media_list[].video.cover.default_url.height	integer	像素高度
media_list[].video.cover.is_gif	boolean	是否为 GIF
media_list[].video.cover.has_raw	boolean	是否有原图
media_list[].video.width	integer	像素宽度
media_list[].video.height	integer	像素高度
media_list[].video.video_time	integer	视频时长
media_list[].video.video_urls	object[]	不同规格视频地址
media_list[].video.video_urls[].spec	integer	资源规格标识
media_list[].video.video_urls[].url	object	资源地址
media_list[].video.video_urls[].url.url	string	资源地址
media_list[].video.video_urls[].url.width	integer	像素宽度
media_list[].video.video_urls[].url.height	integer	像素高度
media_list[].uploader	string	上传者信息
media_list[].batch_id	integer	相册媒体的批次标识
media_list[].upload_time	integer	上传时间
prev_attach_info	string	上一页游标
next_attach_info	string	下一页游标