腾讯会议
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 账户级接口 > 获取账户级已结束会议列表

获取账户级已结束会议列表

最近更新时间：2024-03-05 11:07:32

我的收藏

本页目录：

说明：
账户级接口属于仅账户管理员可以使用的接口，是重量级接口，查询的信息量比较大，访问限制：100次/min。

接口描述

描述：获取账户中在指定时间段内已经结束的会议列表，目前暂不支持 OAuth2.0 鉴权访问。单次最多支持查询10万条数据。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/corp/meetings?page={page}&page_size={page_size}&meeting_state={meeting_state}

输入参数

HTTP 请求头公共参数参考签名验证章节里的 公共参数说明。
参数名称
必选
参数类型
参数描述
page_size
是
Integer
分页大小。
page
是
Integer
当前页。
meeting_code
否
String
会议号。
meeting_state
是
Integer
会议状态：
1：结束会议
2：实时会议
3：即将开始的会议
start_time
否
Integer
搜索开始时间，针对媒体房间的开始时间。
end_time
否
Integer
搜索结束时间，针对媒体房间的开始时间。

输出参数

参数名称
参数类型
参数描述
current_page
Integer
当前页。
current_size
Integer
当前页实际大小。
total_count
Integer
数据总条数。
total_page
Integer
数据总页数。
meeting_info_list
MeetingInfoList 对象数组
会议对象。

MeetingInfoList 对象

参数名称
参数类型
参数描述
meeting_id
String
会议 ID。
meeting_code
String
会议 Code。
subject
String
会议主题。
userid
String
创建者 userid。
userid_type
Integer
创建者 ID 类型。
1：userid
3：rooms_id
nick_name
String
创建者昵称。
start_time
Integer
会议开始时间，媒体房间维度，单位毫秒。
end_time
Integer
会议结束时间，媒体房间维度，单位毫秒。
participants_num
Integer
参会人数。
meeting_duration
String
会议持续时长，单位毫秒。
user_meeting_duration
String
用户会议时长，单位毫秒。

示例

输入示例

GET /v1/corp/meetings?meeting_state=1&page_size=20&page=1

输出示例

{
"total_count":2,
"total_page":1,
"current_page":1,
"current_size":2,
"meeting_info_list":[
    {
        "subject":"test1",
        "meeting_id":"123456987",
        "meeting_code":"13546812",
        "userid":"testuser1",
        "nick_name":"testuesr",
        "start_time":12346554123,
        "end_time":3154842123,
        "participants_num":1,
        "meeting_duration":30057,
        "user_meeting_duration":26728
     },
    {
        "subject":"xianminxiao预定的网络研讨会",
        "meeting_id":"2882809173109452722",
        "meeting_code":"594530158",
        "userid":"xianminxiao",
        "userid_type":1,
        "nick_name":"xianminxiao",
        "start_time":1611143122615,
        "end_time":1611143209838,
        "participants_num":1,
        "meeting_duration":87223,
        "user_meeting_duration":83701
     }
  ]
}

中国站