登录
基础
连接微信
办公通过该接口可以获取所有观看直播的人员统计
请求方式：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" |
权限说明：
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 配置到「上课直播 - 可调用接口的应用」和「家长可以使用的应用」中 |
| 代开发应用 | 具有「直播」和「家校沟通」权限 |
| 第三方应用 | 具有「直播」和「家校沟通」权限 |
注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情
返回结果：
{
"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表示没有评论 |
基础连接微信办公基础连接微信办公基础连接微信办公