修改网络研讨会

接口描述

描述:修改指定的网络研讨会信息,只有网络研讨会的创建者才有权限修改。

注:

1. 商业版账号:按年购买高级账号数不足20个,无法使用该接口。

2. 企业版、教育版账号:购买虚拟会议室数不足10个,无法使用该接口。


调用方式:PUT
接口请求域名

https://api.meeting.qq.com/v1/webinars/{meeting_id}

输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明

参数名称

必选

参数类型

参数描述

meeting_id

String

网络研讨会唯一标识。

userid

String

调用方用于标示用户的唯一 ID(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。<br>企业唯一用户标识说明:<br>1. 企业对接 SSO 时使用的员工唯一标识 ID;<br>2. 企业调用创建用户接口时传递的 userid 参数。

instanceid

Integer

用户的终端设备类型: <br>1:PC <br>2:Mac<br>3:Android <br>4:iOS <br>5:Web <br>6:iPad <br>7:Android Pad <br>8:小程序

subject

String

网络研讨会主题(1~255位字符长度)。

sponsor

String

主办方名称(1~40位字符长度)。

start_time

String

会议开始时间戳(单位秒),不能少于当前时间戳半小时以上。

end_time

String

会议结束时间戳(单位秒)。

admission_type

Integer

观众观看限制类型:<br>0:公开<br>1:报名<br>2:密码

password

String

观众观看密码(4~6位数字),当 admission_type = 2 时必传,且仅当 admission_type = 2 时才生效。

cover_url

String

封面图片 URL,图片仅支持 PNG 和 JPEG 格式,分辨率需大于640*360,推荐使用1280*720的高清图片,文件需控制在 5 MB 以内。

description

String

网络研讨会描述详情,仅支持纯文本,1~5000位字符长度。

enable_guest_invite_link

Boolean

是否开启通过邀请链接自动成为嘉宾:<br>true:开启<br>false:不开启,默认 false

media_setting

媒体参数配置对象

媒体参数配置。

enable_qa

Boolean

是否开启问答:<br>true:开启<br>false:不开启,默认 true

sensitive_words

String 数组

聊天敏感词,包含敏感词的观众公共聊天将不会出现在您的会议中,最多可添加50个敏感词,单个敏感词限制10个中文字符长度。

enable_manual_check

Boolean

是否开启人工审核:<br>true:开启<br>false:不开启,默认 false

媒体参数配置对象

参数名称

必选

参数类型

参数描述

mute_enable_join

Boolean

嘉宾入会时静音。默认值为 false。 <br>true:开启<br>false:不开启

allow_unmute_self

Boolean

允许嘉宾取消静音。默认值为 false。 <br>true:开启<br>false:不开启

allow_in_before_host

Boolean

是否允许嘉宾在主持人进会前加入会议,默认值为 true。 <br>true:允许<br>false:不允许

allow_screen_shared_watermark

Boolean

是否开启屏幕共享水印,默认值为 false。<br>true:开启<br>false:不开启

water_mark_type

Integer

水印样式,默认为单排。当屏幕共享水印参数为开启时,此参数才生效。<br>0:单排<br>1:多排

only_enterprise_user_allowed

Boolean

是否仅企业内部成员可入会,默认值为 false。<br>true:仅企业内部用户可入会<br>false:所有人可入会

auto_record_type

String

自动会议录制类型:<br>none:禁用,表示不开启自动会议录制。<br>local:本地录制,表示主持人入会后自动开启本地录制。<br>cloud:云录制,表示主持人入会后自动开启云录制。<br>**说明:**该参数依赖企业账户设置,当企业强制锁定后,该参数必须与企业配置保持一致。仅客户端2.7.0及以上版本可生效。

participant_join_auto_record

Boolean

当有参会成员入会时立即开启云录制,默认值为 false 关闭:<br>关闭时:主持人入会自动开启云录制。<br>开启时:参会成员入会自动开启云录制。<br>**说明:**该参数必须 auto_record_type 设置为“cloud”时才生效,该参数依赖企业账户设置,当企业强制锁定后,该参数必须与企业配置保持一致。仅客户端2.7.0及以上版本生效。

enable_host_pause_auto_record

Boolean

允许主持人暂停或者停止云录制,默认值为 true 开启:<br>开启时:主持人允许暂停和停止云录制。<br>关闭时:主持人不允许暂停和关闭云录制。<br> **说明:**该参数必须 auto_record_type 设置为“cloud”时才生效,该参数依赖企业账户设置,当企业强制锁定后,该参数必须与企业配置保持一致。仅客户端2.7.0及以上版本生效。

输出参数

参数名称

参数类型

参数描述

meeting_id

String

网络研讨会唯一标识。

meeting_code

String

会议 App 的呼入号码。

示例

输入示例

POST
https://api.meeting.qq.com/v1/webinars/7976035087704477330
{
    "start_time":"1631589648",
    "end_time":"1631589649",
    "media_setting":{
        "mute_enable_join":true,
        "allow_unmute_self":true,
        "allow_in_before_host":true,
        "allow_screen_shared_watermark":true,
        "water_mark_type":1,
        "only_enterprise_user_allowed":false,
        "auto_record_type":"cloud",
        "participant_join_auto_record":true,
        "enable_host_pause_auto_record":true
    },
    "instanceid":1,
    "admission_type":2,
    "password":"1234",
    "sponsor":"564ggg",
    "description":"111",
    "userid":"aaa",
    "subject":"webinar 2",
    "enable_guest_invite_link":true,
    "enable_manual_check":true
}

输出示例

{
    "meeting_id":"7976035087704477330",
    "meeting_code":"887228671"
}
下载 腾讯会议API修改网络研讨会-腾讯会议.pdf
文章内容是否对您有帮助?
有帮助
无帮助