查询录制文件观看流水记录

最近更新时间:2024-07-08 11:48:52

我的收藏

接口描述

描述:
查询会议云录制在一段时间内的观看记录,每次播放都会有一条记录。
支持 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 找到会议录制。

示例

输入示例

GET
https://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 %"
}
]
}