获取用户的会议观看记录

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 手机
email 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
      }
      ]
  }
}