修改会议

最近更新时间:2024-07-08 11:48:51

我的收藏

接口描述

描述
修改某指定会议的会议信息。
企业 secret 鉴权用户可修改任何该企业该用户创建的有效会议,OAuth2.0 鉴权用户只能修改通过 OAuth2.0 鉴权创建的有效会议。
支持企业管理员修改企业下会议。
当您想实时监测会议修改状况时,您可以通过订阅 会议更新 的事件,接收事件通知。
本接口的邀请参会成员限制调整至300人。
当会议为周期性会议时,主持人密钥每场会议固定,但单场会议只能获取一次。支持修改周期性会议的主持人密钥。
注意:
商业版账号:按年购买高级账号数不足20个,无法使用该接口。
企业版、教育版账号:购买虚拟会议室数不足10个,无法使用该接口。
请求方式:PUT
接口请求域名
https://api.meeting.qq.com/v1/meetings/{meetingId}


输入参数

以下请求参数列表仅列出了接口请求参数,HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
meetingId
String
会议的唯一 ID。
userid
String
会议创建者或企业管理员 ID(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。
企业唯一用户标识说明:
1:企业对接 SSO 时使用的员工唯一标识 ID。
2:企业调用创建。
instanceid
Integer
用户的终端设备类型:
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
subject
String
会议主题。长度不能超过512个字节。
当指定修改周期性会议子会议信息时,传入该参数将忽略。
hosts
User 对象数组
会议指定主持人的用户 ID,如果无指定,主持人将被设定为 userId;如果有指定,指定主持人列表需包含 userId(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。如果不传入该字段,则不做修改;如果传入空列表,则该字段清空。
注意:仅腾讯会议商业版和企业版可指定主持人。
企业唯一用户标识说明:
1:企业对接 SSO 时使用的员工唯一标识 ID。
2:企业调用创建用户接口时传递的 userid 参数。
invitees
User 对象数组
调用方用于标示用户的唯一 ID,仅支持邀请与会议创建者同企业的成员(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。
企业唯一用户标识说明:
企业对接 SSO 时使用的员工唯一标识 ID。
企业调用创建用户接口时传递的 userid 参数。
注意:仅腾讯会议商业版和企业版可邀请参会者,邀请者列表仅支持300人;需要邀请超过300人的场景请调用 设置会议邀请成员 接口。
start_time
String
会议开始时间戳(单位秒)。需大于当前时间。
end_time
String
会议结束时间戳(单位秒)。需大于开始时间。
password
String
会议密码(4~6位数字),可不填。如果将字段值改为空字符串"",则表示取消会议密码。
settings
Setting 对象
会议的配置,可为缺省配置。
meeting_type
Integer
默认值为0。
0:普通会议
1:周期性会议
recurring_rule
RecurringRule 对象
周期性会议配置,meeting_type 为1时必填。
enable_live
Boolean
是否开启直播,默认不开启。
live_config
LiveConfig 对象
直播配置对象,enable_live 为 true 时才生效。
enable_doc_upload_permission
Boolean
是否允许成员上传文档,默认为允许。
guests
Guest 对象数组
会议嘉宾列表,不传该字段代表不修改。
注意:传空数组会清空嘉宾列表。一天最多可设置嘉宾10次,且同一用户最多被设置为嘉宾10次。超出限制会议将不会出现在嘉宾会议列表中。
media_set_type
Integer
该参数仅提供给支持混合云的企业可见,默认值为0。
0:公网会议
1:专网会议
enable_enroll
Boolean
是否激活报名。
enable_host_key
Boolean
是否开启主持人密钥。
true:开启
false:关闭
修改周期性会议的主持人密钥适用于接下来的所有子会议。
host_key
String
主持人密钥,仅支持6位数字。
如开启主持人密钥后没有填写此项,将自动分配一个6位数字的密钥。
time_zone
String
时区,可参见 Oracle-TimeZone 标准
location
String
会议地点。最长支持36个汉字或英文字母。
allow_enterprise_intranet_only
Boolean
是否仅允许企业内网络访问入会,仅企业开通混合云功能支持该参数。 false:不限制用户加入会议使用的网络 true: 仅允许通过企业内网络访问加入会议

User 对象

参数名称
必选
参数类型
参数描述
userid
String
用户 ID(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。
企业唯一用户标识说明:
企业对接 SSO 时使用的员工唯一标识 ID,企业调用创建用户接口时传递的 userid 参数。
is_anonymous
boolean
用户是否匿名入会,缺省为 false,不匿名。
true:匿名
false:不匿名
nick_name
String
用户匿名字符串。如果字段“is_anonymous”设置为“true”,但是无指定匿名字符串, 会议将分配缺省名称,例如 “会议用户xxxx”,其中“xxxx”为随机数字。

Setting 对象

参数名称
必选
参数类型
参数描述
mute_enable_type_join
Integer
成员入会时静音选项。
当同时传入“mute_enable_join”和“mute_enable_type_join”时,将以“mute_enable_type_join”的选项为准。
0:关闭
1:开启
2:超过6人后自动开启
mute_enable_join
boolean
入会时静音。
allow_unmute_self
boolean
允许参会者取消静音(暂不支持)。
play_ivr_on_leave
boolean
参会者离开时播放提示音。
play_ivr_on_join
boolean
有新的与会者加入时播放提示音。
allow_in_before_host
boolean
是否允许成员在主持人进会前加入会议,默认值为 true。
true:允许
false:不允许
auto_in_waiting_room
boolean
是否开启等候室,默认值为 false。
true:开启
false:不开启
allow_screen_shared_watermark
boolean
是否开启屏幕共享水印,默认值为 false。
true:开启
false:不开启
water_mark_type
Integer
水印样式,默认为单排。
0:单排
1:多排
only_enterprise_user_allowed
boolean
是否仅企业内部成员可入会,默认值为 false。
true:仅企业内部用户可入会
false:所有人可入会
auto_record_type
String
自动录制类型:
none:禁用,代表不开启自动会议录制。
local:本地录制,代表主持人入会后自动开启本地录制。
cloud:云录制,代表主持人入会后自动开启云录制。
说明:
该参数依赖企业账户设置,当企业强制锁定后,该参数必须与企业配置保持一致。
仅客户端2.7及以上版本可生效。
participant_join_auto_record
boolean
当有参会成员入会时立即开启云录制,默认值为 false 关闭,关闭时,主持人入会自动开启云录制;当设置为开启时,则有参会成员入会自动开启云录制。
说明:
该参数必须 auto_record_type 设置为“cloud”时才生效,该参数依赖企业账户设置,当企业强制锁定后,该参数必须与企业配置保持一致。
仅客户端2.7及以上版本生效。
enable_host_pause_auto_record
boolean
允许主持人暂停或者停止云录制,默认值为 true 开启,开启时,主持人允许暂停和停止云录制;当设置为关闭时,则主持人不允许暂停和关闭云录制。
说明:
该参数必须将 auto_record_type 设置为“cloud”时才生效,该参数依赖企业账户设置,当企业强制锁定后,该参数必须与企业配置保持一致。
仅客户端2.7及以上版本生效。
allow_multi_device
boolean
是否允许成员多端入会。
默认值说明:
若创建会议时主动设置了是否允许多端入会,设置无变化。
若创建会议时没有主动设置:
enable_enroll 为 true 或 password 有值或 auto_in_waiting_room 为 true 或 only_enterprise_user_allowed 为 true,则默认不允许多端入会。
除上条之外的情况,设置无变化。

RecurringRule 对象

参数名称
必选
参数类型
参数描述
recurring_type
Integer
重复类型,默认值为0。
0:每天
1:每周一至周五
2:每周
3:每两周
4:每月
5:自定义,示例请参见 自定义周期规则 API 调用示例
until_type
integer
结束重复类型。
0:按日期结束重复
1:按次数结束重复
until_date
integer
结束日期时间戳,最大支持预定50场子会议。
until_count
integer
限定会议次数(1-50次)。
sub_meeting_id
String
子会议 ID,表示修改该子会议时间,不可与周期性会议规则同时修改。
如不填写,默认修改整个周期性会议时间。
customized_recurring_type
Integer
自定义周期性会议的循环类型。
0:按天。
1:按周。
2:按月,以周为粒度重复。例如:每3个月的第二周的周四。
3:按月,以日期为粒度重复。例如:每3个月的16日。
按周;按月、以周为粒度; 按月、以日期为粒度时,需要包含会议开始时间所在的日期。
customized_recurring_step
Integer
每[n](天、周、月)重复,使用自定义周期性会议时传入。
例如:customized_recurring_type=0 && customized_recurring_step=5 表示每5天重复一次。
customized_recurring_type=2 && customized_recurring_step=3 表示每3个月重复一次,重复的时间依赖于 customized_recurring_days 字段。
customized_recurring_days
Integer
哪些天重复。根据 customized_recurring_type 和 customized_recurring_step 的不同,该字段可取值与表达含义不同。如需选择多个日期,加和即可。
customized_recurring_type = 0 时,传入该字段将被忽略。

LiveConfig 对象

参数名称
必选
参数类型
参数描述
live_subject
String
直播主题。长度最大128个字符。
live_summary
String
直播简介。长度最大400个字符。
enable_live_password
boolean
开启直播密码。
true:开启
false:不开启
live_password
String
直播密码。当设置开启直播密码时,该参数必填。4-6位数字。
enable_live_im
boolean
允许观众讨论。
true:开启
false:不开启
enable_live_replay
boolean
开启直播回看。
true:开启
false:不开启
live_watermark
LiveWatermark 对象
直播水印对象信息。

LiveWatermark 对象

参数名称
必选
参数类型
参数描述
watermark_opt
integer
水印选项,默认为0。
0:默认水印
1:无水印

Guest 对象

参数名称
必选
参数类型
参数描述
area
String
国家/地区代码(例如:中国传86,不是+86,也不是0086)。
phone_number
String
手机号。
guest_name
String
嘉宾名称。

输出参数

参数名称
参数类型
参数描述
meeting_number
integer
会议数量。
meeting_info_list
MeetingInfo 对象数组
会议列表。

MeetingInfo 对象

参数名称
参数类型
参数描述
meeting_id
String
会议 ID。
meeting_code
String
会议号码。
enable_live
Boolean
是否开启直播。
live_config
LiveCfg 对象
直播配置对象,内部只返回 live_addr(直播观看地址)。
host_key
String
主持人密钥,仅支持6位数字。
如开启主持人密钥后没有填写此项,将自动分配一个6位数字的密钥。

LiveCfg 对象

参数名称
参数类型
参数描述
live_addr
String
直播观看地址。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法,请对照接口文档检查您的参数。
400
20006
修改的时间段内存在会议室被占用。
400
14152
修改时间不能早于当前时间。
400
190457
会议不存在, 请核对 meeting_id。
400
190301
请求重放错误,请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成,不能使用和过去五分钟内相同的 timestamp 和 nonce。
400
9042
无权限进行该操作,建议检查操作者身份或资源归属。
500
9044
成员人数超过限制。
500
9007
会议已取消。
500
9094
位置信息包含敏感词。
500
13000
缓存查询会议信息失败。
500
14151
会议已开始,不能修改会议信息。
500
14154
无权限操作。
500
20001
请检查白名单参数。
500
9042
没有权限。
500
9042
无权限进行该操作,建议检查操作者身份或资源归属。
500
9063
子会议场次超过最大限制。
500
9102
无权限修改会议。
500
14157
会议修改失败,请检查结束时间的设置。
500
9131
修改会议失败。
500
500021
子会议场次超过最大限制。
500
190310
每分钟总接口调用次数超过限制。
500
13001
缓存设置会议信息失败。
500
9003
MEETING NOT EXIST。
500
500023
周期会议子会议时间重叠。
500
9093
会议主题包含敏感词。
500
400006
修改会议成功,直播设置错误。
500
500043
修改会议邀请者日程状态失败。
500
500022
周期会议分段修改分段时间重叠。
500
190308
查询 tinyID 失败。
500
190001
存在未注册的用户。
500
14152
会议已结束,不能修改会议信息。
500
9002
非法请求。
500
41
网络错误,请稍后重试。

示例

输入示例

PUT https://api.meeting.qq.com/v1/meetings
{
"userid" : "tester",
"instanceid" : 1,
"subject" : "tester's meeting",
"hosts" : ["tester"],
"invitees" : ["test1", "guest1", "guest2"],
"start_time" : "1572172200",
"end_time" : "1572175800",
"password" : "1111",
"enable_host_key":true,
"user_non_registered":["test1","test2"],
"settings" : {
"mute_enable_type_join":2,
"allow_unmute_self":false,
"play_ivr_on_leave": false,
"play_ivr_on_join": false,
"allow_in_before_host":true,
"auto_in_waiting_room":false,
"allow_screen_shared_watermark":false,
"only_enterprise_user_allowed":false
},
"meeting_type":1,
"recurring_rule":{
"recurring_type":0,
"until_type":1,
"until_count":7,
"until_date":1600682957
},
"enable_live": true,
"live_config": {
"live_subject":"test_subject",
"live_summary":"test_summary",
"enable_live_password": true,
"live_password":"1234",
"enable_live_im": true,
"enable_live_replay": true
}
}

输出示例

{
"meeting_number": 1,
"meeting_info_list":[
{
"subject": "tester's meeting",
"meeting_id": "433471464134410364",
"meeting_code": "637228110",
"password": "1111",
"start_time" : "1572172200",
"end_time" : "1572175800",
"hosts":["test1"],
"participants":[],
"join_url": "https://wemeet.qq.com/w/5oxCqAc",
"settings":{
"mute_enable_type_join": 2
},
"enable_live":true,
"live_config":{
"live_addr":"https://meeting.tencent.com/l/ehewFSfengBPae"
},
"host_key":"415411"
}
]
}