企业内部开发 服务端API 家校应用 上课直播 获取观看直播统计V2
获取观看直播统计V2

通过该接口可以获取所有观看直播的人员统计

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/school/living/get_watch_stat_v2?access_token=ACCESS_TOKEN

请求包体:

{
	"livingid": "livingid1",
	"next_cursor": "NEXT_CURSOR"
}

参数说明:

参数必须说明
access_token调用接口凭证
livingid直播的id
next_cursor上一次调用时返回的next_cursor,初次调用可以填"0"

权限说明:

  • 「上课直播」应用可以获取用户所有的直播
  • 第三方应用必须有直播权限和家校沟通权限
  • 自建应用必须通知配置到「上课直播」和家长可以使用的应用中
  • 自建应用和第三方应用只能获取本应用创建的直播

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "has_more":1,
   "next_cursor": "NEXT_CURSOR",
   "stat_info":{
   "students":[
			{
				"student_userid": "zhansan_child",
				"partyids":[
					10,11
				],
				"watch_time": 30,
				"enter_time": 1586433904,
				"leave_time": 1586434000,
				"is_comment": 1
			}
			{
				"student_userid": "lisi_child",
				"partyids":[
					10,11
				],
				"watch_time": 30,
				"enter_time": 1586433904,
				"leave_time": 1586434000,
				"is_comment": 0
			}
		],
		"parents":[
			{
				"parent_userid": "zhangsan",
				"student_userid": "zhansan_child",
				"partyids":[
					10,11
				],
				"watch_time": 30,
				"enter_time": 1586433904,
				"leave_time": 1586434000,
				"is_comment": 1
			}
			{
				"parent_userid": "lisi",
				"student_userid": "lisi_child",
				"partyids":[
					10,11
				],
				"watch_time": 30,
				"enter_time": 1586433904,
				"leave_time": 1586434000,
				"is_comment": 0
			}
		],
		"visitors":[
			{
				"nickname": "wx_nickname1",
				"watch_time": 30,
				"enter_time": 1586433904,
				"leave_time": 1586434000,
				"is_comment": 1
			},
			{
				"nickname": "wx_nickname2",
				"watch_time": 30,
				"enter_time": 1586433904,
				"leave_time": 1586434000,
				"is_comment": 0
			}
		]
   }
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
has_more是否结束。1:表示还有更多数据,需要继续拉取,0:表示已经拉取完所有数据。注意只能根据该字段判断是否已经拉完数据
next_cursor当前数据最后一个cursor值,如果下次调用带上该值则从该cursor值往后拉,用于实现分页拉取
stat_info统计信息列表
stat_info.students观看直播的学生列表
stat_info.students.student_userid学生的userid
stat_info.students.partyids学生所在的班级id列表
stat_info.students.watch_time观看时长,单位为秒
stat_info.students.enter_time首次进入直播时间
stat_info.students.leave_time最后离开直播时间
stat_info.students.is_comment是否评论,1表示评论,0表示没有评论
stat_info.parents观看直播的家长列表
stat_info.parents.parent_userid家长的userid
stat_info.parents.student_userid家长对应学生的userid
stat_info.parents.partyids家长对应学生所在的班级id列表
stat_info.parents.watch_time观看时长,单位为秒
stat_info.parents.enter_time首次进入直播时间
stat_info.parents.leave_time最后离开直播时间
stat_info.parents.is_comment是否评论,1表示评论,0表示没有评论
stat_info.visitors观看直播的游客列表
stat_info.visitors.nickname微信昵称
stat_info.visitors.watch_time观看时长,单位为秒
stat_info.visitors.enter_time首次进入直播时间
stat_info.visitors.leave_time最后离开直播时间
stat_info.visitors.is_comment是否评论,1表示评论,0表示没有评论
上一篇
删除直播回放
下一篇
获取未观看直播统计V2