腾讯会议Rest API网络研讨会封面/会议背景图片设置结果返回变为异步方式变更通知

2022-11-15 16:59:58 浏览数 (2)

影响范围:

1、创建网络研讨会cover_url 封面图片上传结果返回

https://cloud.tencent.com/document/product/1095/61868

2、修改网络研讨会cover_url 封面图片上传结果返回

https://cloud.tencent.com/document/product/1095/61964

3、添加会议背景接口

https://cloud.tencent.com/document/product/1095/56330

上线时间:

1、Webhook素材上传结果事件消息订阅配置:已上线

2、接口结果返回由同步方式变为异步方式:2022年12月1日

变更前:

1、调用创建/修改网络研讨会接口后等待封面图片上传及其他设置结果返回

2、调用添加会议背景接口后等待结果返回

变更后:

1、调用创建/修改网络研讨会接口后,除设置封面图片外其他参数设置等待结果返回,封面图片在Webhook 素材上传结果事件消息中返回。

2、调用添加会议背景接口后在Webhook 素材上传结果事件消息中返回。

3、Webhook 素材上传结果事件消息内容示例:

代码语言:javascript复制
{
    "event":"meeting.medium-uploaded", //事件名
    "trace_id":"e7aa65dd-f7e6-4b62-912c-2035173b34a9",//事件的唯一序列值,可对应到具体请求
    "payload":[
        {
            "operate_time":1609313201465,//毫秒级别事件操作时间戳,成功/失败时间点
            "event_upload_status":true,//上传事件是否成功,true:全部素材上传成功;false:存在素材上传失败,需重新上传全部素材
			"upload_info":[  //根据本次请求中的上传素材类型数量决定对象个数
			       {
				"upload_status":true, //true:上传成功;false:上传失败
				"error_msg":"",//如果上传失败,则该字段返回失败原因
                "medium_type":1, //1:video,2:pic,3:file
				"medium_url":""
			        }
                    {
				"upload_status":true, //true:上传成功;false:上传失败
				"error_msg":"",//如果上传失败,则该字段返回失败原因
                "medium_type":2, //1:video,2:pic,3:file
				"medium_url":""
			        }
                        ]
                "meeting_info":{//会议信息
                "meeting_id":"13339451618278424869",// 会议id
                "meeting_code":"445999969", // 会议code
                "subject":"tester的快速会议", // 会议主题
                "meeting_type":0,// 会议类型(0-一次性会议,1-周期性会议,2-微信专属会议,3-rooms投屏会议,5-个人会议号会议,6-网络研讨会)
                "start_time":1608522626,// 秒级别的会议开始时间戳
                "end_time":1609415039// 秒级别的会议结束时间戳
            }
        }
    ]
}

适配方法一(优先建议):

1、参考官网材料对接webhook(已对接过可略过),参考文档:https://cloud.tencent.com/document/product/1095/51605

2、订阅素材上传结果事件消息

3、调用Rest API接口时记录返回的X-Tc-Trace参数,参考文档:https://cloud.tencent.com/document/product/1095/51830

4、接收到素材上传结果事件消息后,根据其中的trace_id参数和之前记录的X-Tc-Trace参数进行对比,确认设置结果。

适配方法二(不建议)

1、调用受影响的接口设置背景/封面图片。

2、一段时间后(时长取决于图片文件的大小及文件所在服务器与腾讯会议后台之间的网络状况),调用查询会议背景列表接口获取会议背景图片结果/调用查询网络研讨会接口获取封面图片设置结果。

0 人点赞