获取会议健康度 - 文档 - 企业微信开发者中心

最后更新：2023/05/12

获取已结束会议的会议及参会成员的健康度。

请求方式： POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/meeting/get_quality?access_token=ACCESS_TOKEN

{
	"meetingid": "MEETINGID",
	"sub_meetingid": "SUB_MEETING_ID",
	"start_time": 168888888,
	"cursor": "CURSOR",
	"limit": 20
}

参数	必须	类型	说明
access_token	是	string	调用接口凭证。获取方法查看“获取access_token”
meetingid	是	string	会议ID
sub_meetingid	否	string	周期性子会议ID 说明：可通过查询成员的会议列表、查询会议接口获取返回的子会议 ID，即 current_sub_meetingid；如果是周期性会议，此参数必传。
start_time	是	int32	参会时间过滤起始时间，UNIX 时间戳（单位秒），可查询的时间区间为过去7天到现在。返回 meeting_id 对应会议房间下，开始时间大于等于 start_time 且离 start_time 最近的一个媒体房间数据（从第一个人入会到会中成员全部离开会议形成一个媒体房间，若同一会议号下再次有人入会则形成新的媒体房间）。
cursor	否	string	分页查询用，将上一个请求返回的next_cursor字段传入。第一次查询时可不传值
limit	否	int32	分页大小，默认50，最大50

注意：
limit参数必须与首次调用获得cursor时传入的limit一致。

仅配置在“可调用接口的应用”列表中的自建应用可调用
仅允许查询该应用创建的会议的数据
仅返回在应用可见范围内的成员

{
	"errcode": 0,
	"errmsg": "ok",
	"quality": 0,
	"audio_quality": 1,
	"video_quality": 2,
	"screen_share_quality": 1,
	"network_quality": 1,
	"problems": [
		"PROBLEM1"
	],
	"attendees":[
		{
			"userid": "USERID",
			"tmp_openid": "TMP_OPENID",
			"instance_id": 1,
			"quality": 1,
			"audio_quality": 1,
			"video_quality": 1,
			"screen_share_quality": 1,
			"network_quality": 1,
			"problems":[
				"PROBLEM1"
			]
		}
	],
	"next_cursor": "NEXT_CURSOR",
	"has_more": true
}

参数	类型	说明
errcode	int32	返回码
errmsg	string	对返回码的文本描述内容
quality	int32	健康度： 0：无数据 1：健康 2：告警
audio_quality	int32	音频质量： 0：无数据 1：好 2：较好 3：中 4：差
video_quality	int32	视频质量： 0：无数据 1：好 2：较好 3：中 4：差
screen_share_quality	int32	共享屏幕质量： 0：无数据 1：好 2：较好 3：中 4：差
network_quality	int32	网络质量： 0：无数据 1：好 2：较好 3：中 4：差
problems	string[]	告警的具体问题列表
attendees	object[]	参会人员健康度列表（按成员入会时间正序排列，入会越早的在越上面；成员使用不同端入会时平铺返回数据，instance_id 不同）。详见Attendee。
next_cursor	string	分页用，下一次拉取列表将该字段填入cursor字段
has_more	bool	是否还有待拉取的列表

Attendee说明

参数	类型	说明
userid	string	成员userid
tmp_openid	string	当场会议的成员临时 ID，可用于会控操作，适用于所有成员。
instance_id	int32	成员的终端设备类型： 0：PSTN 1：PC 2：Mac 3：Android 4：iOS 5：Web 6：iPad 7：Android Pad 8：小程序 9：voip、sip 设备 10：linux 20：Rooms for Touch Windows 21：Rooms for Touch MacOS 22：Rooms for Touch Android 30：Controller for Touch Windows 32：Controller for Touch Android 33：Controller for Touch iOS
quality	int32	健康度： 0：无数据 1：健康 2：告警
audio_quality	int32	音频质量： 0：无数据 1：好 2：较好 3：中 4：差
video_quality	int32	视频质量： 0：无数据 1：好 2：较好 3：中 4：差
screen_share_quality	int32	共享屏幕质量： 0：无数据 1：好 2：较好 3：中 4：差
network_quality	int32	网络质量： 0：无数据 1：好 2：较好 3：中 4：差
problems	string[]	告警的具体问题列表

网络研讨会 (Webinar) 管理

电话入会（PSTN）管理

会议室连接器（MRA）管理