接口描述
描述：
查询会议云录制在一段时间内的观看记录，每次播放都会有一条记录。
支持 JWT 和 OAuth，OAuth 2.0鉴权用户只能获取该企业下 OAuth 2.0应用创建的会议记录。
权限点：查看会议录制或管理会议录制。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/records/view-details?record_file_id={record_file_id}&operator_id={operator_id}&operator_id_type={operator_id_type}&page_size={page_size}&page={page}&start_time={start_time}&end_time={end_time}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
record_file_id | 是 | String | 录制文件 ID。 |
operator_id_type | 是 | Integer | 操作者 ID 的类型： 1：userid 2：open_id |
operator_id | 是 | String | 操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值，operator_id 代表不同类型。 |
page_size | 否 | Integer | 分页大小，默认20，最大50。 |
page | 否 | Integer | 页码，从1开始，默认1。 |
start_time | 否 | Integer | 查询起始时间戳，UNIX 时间戳（单位毫秒）。 说明：仅存储最近31天的数据，默认展示最近31天的数据。 |
end_time | 否 | Integer | 查询结束时间戳，UNIX 时间戳（单位毫秒）。 说明：仅存储最近31天的数据，默认展示最近31天的数据。 |
输出参数
参数名称 | 参数类型 | 参数描述 |
total_count | Integer | 分页查询返回数据总数。 |
current_size | Integer | 分页查询返回单页数据条数。 |
current_page | Integer | 分页查询返回当前页码。 |
total_page | Integer | 分页查询返回分页总数。 |
view_details | ViewDetail 对象数组 | 事件明细集合。 |
ViewDetail 对象
参数名称 | 参数类型 | 参数描述 |
view_start_time | Integer | 观看开始时间，UNIX 时间戳（单位毫秒）。 |
view_end_time | Integer | 观看结束时间，UNIX时间戳（单位毫秒）。 |
view_time | Integer | 实际观看时长（单位毫秒）。 |
userid | String | 所在同一企业下的用户 ID。 |
user_name | String | 用户名称。匿名用户给出匿名用户标识。 |
record_file_name | String | 录制文件名称。 |
total_view_progress | String | 观看完成度（百分比），该用户累计观看该视频的完成度。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 9042 | 无权限进行该操作，建议检查操作者身份或资源归属。 |
400 | 190004 | 参数非法，请对照接口文档检查您的参数。 |
500 | 400 | 未根据会议录制 ID 找到会议录制。 |
示例
输入示例
GEThttps://api.meeting.qq.com/v1/records/view-details?record_file_id=123456&operator_id_type=1&operator_id=aaaa&page_size=50&page=1&start_time=1693554563000&end_time=1694764419000
输出示例
{"total_count": 1,"current_size": 50,"current_page": 1,"total_page": 1,"view_details": [{"view_start_time": 1694764238754,"view_end_time": 1694764315776,"view_time": 75007,"userid": "aaaa","open_id": "","user_name": "aaaa","record_file_name": "录制1","total_view_progress": "8 %"}]}
