登录
基础
连接微信
办公该接口用于修改一个指定的预约会议。
请求方式： POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/meeting/update?access_token=ACCESS_TOKEN
请求包体：
{
"meetingid": "hyxxx",
"title": "新建会议",
"meeting_start": 1600000000,
"meeting_duration": 3600,
"description": "新建会议描述",
"location":"广州媒体港",
"invitees": {
"userid": ["lisi", "wangwu"]
},
"settings": {
"password": "1234",
"enable_waiting_room": false,
"allow_enter_before_host": true,
"enable_enter_mute": 1,
"allow_unmute_self":true,
"mute_all":false,
"allow_external_user": false,
"enable_screen_watermark": false,
"watermark_type":1,
"auto_record_type":"none",
"attendee_join_auto_record":false,
"enable_host_pause_auto_record":false,
"enable_enroll":true,
"enable_host_key":true,
"host_key":"meetinghostkey",
"hosts": {
"userid": ["lisi", "wangwu"]
},
"remind_scope": 4,
"ring_users": {
"userid": ["zhangsan", "lis"]
}
},
"cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA",
"reminders": {
"is_repeat": 1,
"repeat_type": 0,
"is_custom_repeat":1,
"repeat_until_type":1,
"repeat_until_count":10,
"repeat_until": 1606976813,
"repeat_interval": 1,
"repeat_day_of_week": [3, 7],
"repeat_day_of_month": [10, 21],
"remind_before": [0, 900]
}
}参数说明：
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 调用接口凭证。获取方法查看“获取access_token” |
| meetingid | 是 | string | 会议id，仅允许修改预约状态下的会议 |
| title | 否 | string | 会议的标题（1~255位字符长度） |
| meeting_start | 否 | uint32 | 会议开始时间的unix时间戳。需大于当前时间。 注意：修改该字段时必须同时指定meeting_duration。对于非周期性会议，如果创建会议时指定的开始时间小于当前时间，则在更新会议时需要指定meeting_start |
| meeting_duration | 否 | uint32 | 会议持续时间单位秒，最小300秒 。 注意：修改该字段时，必须同时指定meeting_start。对于非周期性会议，如果创建会议时指定的开始时间小于当前时间，则在更新会议时需要指定meeting_duration |
| description | 否 | string | 会议的描述，最多支持500个字节或者utf8字符 |
| location | 否 | string | 会议地点。最长支持18个汉字或36个英文字母。 |
| invitees | 否 | object | 邀请参与会议的成员。人数上限以指定的「管理员」可预约的人数上限来校验： 普通企业与会人员最多100 付费企业根据企业选购的在线会议室容量，但最多不能超过300人，若超过300人请调用更新会议受邀成员列表接口 注意： 任何userid不合法或者不在应用可见范围，直接报错。 |
| invitees.userid | 否 | userid | 参与会议的企业成员userid |
| cal_id | 否 | string | 会议所属日历ID。该日历必须是access_token所对应应用所创建的日历。 注意，若参与人在日历分享范围内，则插入到该日历（同时会插入会议参与人的默认日历），若不在分享范围内，否则仅插入到参与者默认日历； 如果不填，那么插入到参与者的默认日历上。 第三方应用必须指定cal_id 不多于64字节 |
| settings | 否 | object | 会议配置，详见Settings |
| reminders | 否 | object | 重复会议相关配置，详见Reminders |
Settings说明：
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| password | 否 | string | 入会密码，仅可输入4-6位纯数字 |
| enable_waiting_room | 否 | bool | 是否开启等候室。 true：开启等候室 false：不开启等候室 |
| allow_enter_before_host | 否 | bool | 是否允许成员在主持人进会前加入。 true：允许 false：不允许 |
| enable_enter_mute | 否 | uint32 | 成员入会时静音选项。 1：开启 0：关闭 2：超过6人后自动开启静音 |
| allow_unmute_self | 否 | bool | 允许参会者取消静音。 true：允许 false：不允许 |
| mute_all | 否 | bool | 是否全体静音。该字段单独使用不生效，当设置allow_unmute_self为false时，需要指定mute_all=true |
| watermark_type | 否 | uint32 | 水印样式，默认为单排。 0：单排 1：多排 |
| auto_record_type | 否 | string | 自动会议录制类型。 none：禁用，表示不开启自动会议录制 local：本地录制，表示主持人入会后自动开启本地录制 cloud：云录制，表示主持人入会后自动开启云录制。 |
| attendee_join_auto_record | 否 | bool | 是否在有参会成员入会时立即开启云录制。 关闭时，主持人入会自动开启云录制 开启时，有参会成员入会自动开启云录制 只有auto_record_type=cloud时才能配置该字段 |
| enable_host_pause_auto_record | 否 | bool | 是否允许主持人暂停或者停止云录制。 允许时，主持人可以暂停和停止云录制 当设置为不允许，则主持人不能暂停和关闭云录制。 只有auto_record_type=cloud时才能配置该字段 |
| enable_enroll | 否 | bool | 是否激活报名 |
| enable_host_key | 否 | bool | 是否开启主持人密钥。 true：开启 false：关闭 |
| host_key | 否 | string | 主持人密钥，仅支持6位数字。如开启主持人密钥后没有填写此项，将自动分配一个6位数字的密钥。 |
| allow_external_user | 否 | bool | 是否允许企业外部成员入会。 true：所有成员可入会 false：仅企业内部成员可入会 。默认所有成员可入会 |
| enable_screen_watermark | 否 | bool | 是否开启屏幕水印。 true：开启 false：不开启 |
| hosts | 否 | object | 会议主持人列表，最多10个。若包含admin_userid会自动过滤。任何userid不合法，直接报错。 |
| hosts.userid | 否 | string[] | 企业成员userid |
| remind_scope | 否 | uint32 | 会议开始时来电提醒方式，1.不提醒 2.仅提醒主持人 3.提醒所有成员入 4.指定部分人响铃。默认仅提醒主持人 |
| ring_users | 否 | object | 指定响铃的成员列表。如果remind_scope为4，但是ring_users为空，则全部成员均不响铃。 |
| ring_users.userid | 否 | string[] | 指定响铃的成员userid |
Reminders说明：
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| is_repeat | 否 | uint32 | 周期性会议设置。 1：周期性会议 0：非周期性会议 |
| repeat_type | 否 | uint32 | 重复类型，当is_repeat为1时有效。目前支持如下类型： 0 - 每日 1 - 每周 2 - 每月 7 - 工作日 当指定为自定义重复时，仅能选择按每日、每周或者每月重复 |
| is_custom_repeat | 否 | uint32 | 是否自定义周期性会议重复设置。 0：否 1：是 当is_repeat为1时有效 |
| repeat_interval | 否 | uint32 | 重复间隔 当指定为自定义重复时必填 该字段随repeat_type不同而含义不同 例如： repeat_interval指定为3，repeat_type指定为每周重复，那么每3周重复一次； repeat_interval指定为3，repeat_type指定为每月重复，那么每3个月重复一次 |
| repeat_day_of_week | 否 | uint32[] | 每周周几重复 仅当指定为自定义重复且重复类型为每周时有效 取值范围：1 ~ 7，分别表示周一至周日。 注意：自定义按周重复时，会议开始时间对应的那天需要包含在该数组中。例如：开始时间是周一，则该数组需要包含1，如果开发者没有指定，后台会补上 |
| repeat_day_of_month | 否 | uint32[] | 每月哪几天重复 仅当指定为自定义重复且重复类型为每月时有效 取值范围：1 ~ 31，分别表示1~31号。 注意：自定义按月重复时，会议开始时间对应的那天需要包含在该数组中。例如：开始时间是某月1号，则该数组需要包含1，如果开发者没有指定，后台会补上 |
| repeat_until_type | 否 | uint32 | 结束重复类型，默认值为0。0：按日期结束重复；1：按次数结束重复 |
| repeat_until_count | 否 | uint32 | 周期会议限定次数。 说明： 1-每天、每个工作日、每周最大支持200场子会议 2-每月最大支持50场子会议 |
| repeat_until | 否 | uint32 | 周期会议结束时刻。repeat_until_type=0时该字段才生效。若会议结束时间超出最大结束时间或者未设置，则默认设置为最大结束时间。每天\每个工作日\每周 最多重复200次会议；每月最多重复50次会议 |
| remind_before | 否 | uint32[] | 指定会议开始前多久提醒成员，相对于meeting_start前的秒数。目前仅支持 0：会议开始时提醒 300：5分钟前提醒 900：15分钟前提醒 3600：一小时前提醒 86400：一天前提醒 若指定了非支持的值，则表现为会议开始时提醒 |
权限说明：
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"excess_users":["lisi","wangwu"]
}参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 对返回码的文本描述内容 |
| excess_users | string | 参会人中包含无效会议账号的userid，仅在购买会议专业版企业由于部分参会人无有效会议账号时返回 |
注：若会议为指定创建者的老会议，修改会议时，则不允许指定应用身份创建的新日历。
基础连接微信办公基础连接微信办公基础连接微信办公