获取用户的会议观看记录
1.接口描述
观看记录定义:
仅统计用户在此时间段内, 有离线时间记录的用户, 在此时间段仍在观看, 没有离线时间记录的用户, 在下个时间段调用时获得。 无论在那个时间段统计, 同一个用户的观看时间, 为此用户在本场会议中所有观看时间的累计时间。
接口名称:
/eventopenapi/event/report/getDataByTime
发送方式:
POST
参数格式:
accept: application/json;content-type: application/json
2. 输入参数
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
token | String | 是 | 统一鉴权token, 调用全时Open API凭证 |
eventId | Long | 是 | 会议ID |
startTime | Long | 否 | 开始时间(单位:秒)不传开始时间或截止时间, 默认取本场会议的所有数据 |
endTime | Long | 否 | 结束时间(单位:秒)不传开始时间或截止时间, 默认取本场会议的所有数据 |
liveType | Integer | 否 | 观看类型 -1:直播+回访(不传默认-1), 0: 观看直播,1:观看回访 |
3. 输出参数
参数 | 类型 | 说明 |
---|---|---|
timeStamp | Long | 返回时间(时间戳,单位毫秒) |
requestId | String | 请求ID(在接口异常时, 需提供请求ID) |
code | Int | 返回的状态码 |
msg | String | 当返回结果的状态码不为200时,包含的错误信息 |
data | json | 返回数据 |
data 参数说明
参数 | 类型 | 说明 |
---|---|---|
viewerDetails | Array | 参会明细数据, 一个用户只有一条记录 |
viewerDetails 参数说明
参数 | 类型 | 说明 |
---|---|---|
conferenceId | String | 会议ID |
billingCode | String | 会议BC |
hostId | String | 主持人ID |
extId | String | 第三方ID |
mobile | String | 手机 |
String | 邮箱 | |
name | String | 姓名 |
online_time | Long | 上线时间 (时间戳,单位秒) |
offline_time | Long | 下线时间 (时间戳,单位秒) |
duration | Int | 时长 (单位秒) |
ip | String | IP (观众外网请求IP) |
iden | String | 身份 |
type | String | 观看入口 |
live_type | String | 观看类型 |
auth_type | String | 是否白名单 |
device_type | String | 观看设备 |
client_type | String | 客户端类型 |
company | String | 公司 |
location | String | 地域 (IP所对应国/省/市) |
whitelist_type | String | 白名单类型 |
whitelist_tag | String | 白名单标签 |
times | Int | 合计观看次数 |
liveTimes | Int | 直播观看次数 |
replayTimes | Int | 回放观看次数 |
watchDuration | String | 合计观看时长 |
liveWatchDuration | String | 直播观看时长 |
replayWatchDuration | String | 回放观看时长 |
chat_num | Int | 聊天/弹幕数量 |
praise_num | Int | 点赞数量 |
raise_hand_num | Int | 举手发言次数 |
quiz_num | Int | 提问次数 |
goods_sum_hits | Int | 商品点击次数 |
survey | String | 是否参与答题 |
vote | String | 是否参与投票 |
sign | String | 是否签到 |
envelope | String | 是否领红包 |
group | String | 分组 |
call_duration | Int | 合计发言时长 |
4. 示例
输入示例
{
"token":"5d41c4ac806c6440eb6aa8e071115f2b",
"eventId": 609768,
"startTime": 1673402400,
"endTime": 1673404200,
"liveType": 0
}
输出示例
{
"timeStamp": 1666948293682,
"code": 200,
"msg": "Successfully to get the event viewer details!",
"requestId": "172.10.85.69_20221028_171133_1666948293406",
"data": {
"eventId": 609768,
"startTime": 1673402400,
"endTime": 1673404200,
"liveType": 0,
"viewerDetails": [
{
"whitelist_tag": "-",
"sign": "N",
"live_type": "直播",
"device_type": "Windows",
"client_type": "客户端",
"type": "互动端",
"call_duration": 0,
"duration": 2060,
"times": 1,
"online_time": 1666772492,
"raise_hand_num": 0,
"replayWatchDuration": "00:00:00",
"replayTimes": 0,
"praise_num": 0,
"offline_date": "2022-10-26 16:55:52",
"company": "新建管理中心测试25",
"extId": "-",
"liveWatchDuration": "00:34:20",
"vote": "N",
"email": "-",
"group": "新建管理中心测试25",
"auth_type": "否",
"ip": "192.168.40.44",
"whitelist_type": null,
"mobile": "19000101106",
"watchDuration": "00:34:20",
"hostId": 88589655,
"goods_sum_hits": 0,
"chat_num": 0,
"billingCode": "95469279",
"offline_time": 1666774552,
"quiz_num": 0,
"envelope": "N",
"conferenceId": "239790940",
"iden": "主持人",
"name": "用户6",
"online_date": "2022-10-26 16:21:32",
"survey": "N",
"location": "-",
"liveTimes": 1
},
{
"whitelist_tag": "-",
"sign": "N",
"live_type": "直播+回放",
"device_type": "Windows,iOS",
"client_type": "Web",
"type": "直播端",
"call_duration": 0,
"duration": 86,
"times": 3,
"online_time": 1666772823,
"raise_hand_num": 0,
"replayWatchDuration": "00:00:29",
"replayTimes": 2,
"praise_num": 0,
"offline_date": "2022-10-26 17:34:18",
"company": "-",
"extId": "-",
"liveWatchDuration": "00:00:57",
"vote": "N",
"email": "-",
"group": "-",
"auth_type": "否",
"ip": "192.168.40.44,117.39.199.234",
"whitelist_type": null,
"mobile": "+86-19000101106",
"watchDuration": "00:01:26",
"hostId": 88589655,
"goods_sum_hits": 0,
"chat_num": 0,
"billingCode": "95469279",
"offline_time": 1666776858,
"quiz_num": 0,
"envelope": "N",
"conferenceId": "239790940",
"iden": "观众",
"name": "网友1009",
"online_date": "2022-10-26 16:27:03",
"survey": "N",
"location": "-,陕西西安",
"liveTimes": 1
}
]
}
}