腾讯会议修改会议布局-开放平台文档-文档中心-腾讯云

接口描述
描述：
根据布局 ID 对设置好的会议布局进行修改。
用户座次设置区分会前和会中两种方式：会前只允许设置邀请者成员，会中只允许设置参会成员。
目前暂不支持 OAuth2.0 鉴权访问。
请求方式：PUT
接口请求域名：
https://api.meeting.qq.com/v1/meetings/{meeting_id}/layouts/{layout_id}
﻿
输入参数
HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
meeting_id
是
String
会议 ID。
layout_id
是
String
布局 ID。
userid
是
String
会议创建者 ID。
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
page_list
是
PageList 对象数组
布局单页对象列表。
enable_set_default
否
Boolean
是否设置为会议应用的布局，默认不设置。
PageList 对象
参数名称
必选
参数类型
参数描述
layout_template_id
是
String
布局模板 ID。
user_seat_list
否
UserSeatList 对象数组
用户座次对象列表。
UserSeatList 对象
参数名称
必选
参数类型
参数描述
grid_id
是
String
宫格 ID。
grid_type
是
Integer
注意：多次传入同一宫格 ID 的对象，仅第一次出现的对象生效。
宫格类型：
1：视频画面（此类型需传递 userid 或 uuid、username 入参，作为视频画面展示；若会中参会成员有外部企业用户，需传递该用户的 uuid；如果 userid、uuid 同时传递则以 uuid 为准）。
2：共享画面。
3：拓展应用（目前一页仅可添加一个应用）。
添加的应用需满足以下条件：
与会议绑定。
开启网页服务。 
同企业下的仅企业内可见应用或外部企业可见应用。
userid
否
String
用户 ID。
uuid
否
String
用户身份 ID（腾讯会议颁发的用于开放平台的唯一用户 ID）。
username
否
String
用户昵称。
ms_open_id
否
String
当场会议的用户临时 ID。
tool_sdkid
否
String
拓展应用 ID。
输出参数
无输出参数，成功返回空消息体，失败返回 错误码 和错误信息。
错误码列表
状态码
错误码
错误描述
400
20012
不存在的布局 ID。
400
20020
会中非参会成员不得设置座次。
400
20011
会前非邀请成员不得设置座次。
400
190004
参数非法，请对照接口文档检查您的参数。
400
20027
不存在的布局模板 ID。
400
20028
不存在的布局宫格 ID。
500
202004
Oauth 鉴权时查询 secret 信息失败。
500
9042
没有权限。
500
960000
网络错误，请稍后重试。
500
9003
会议信息不存在。
500
190001
存在未注册的用户。
500
41
网络错误，请稍后重试。
500
13703
查询会议失败。
示例
输入示例
PUT
https://api.meeting.qq.com/v1/meetings/6524541286408448530/layouts/03acdd90-b0b2-41dd-8484-648f3d284070
{
    "userid":"creator1",
    "instanceid":1,
    "page_list":[
        {
            "layout_template_id":"1",
            "user_seat_list":[
                {
                    "grid_id":"10",
                    "grid_type":1,
                    "userid":"invitee1",
                    "username":"joker",
                    "ms_open_id": "68+lhnxxxxxxxxxxxxxxxxhqQC7o4kFb3xxxxxxxxxxxxh+tJ3+j2xkYT1"
                },
                {
                    "grid_id":"1",
                    "grid_type":1,
                    "userid":"invitee2",
                    "username":"batman",
                    "ms_open_id": "68+lhnxxxxxxxxxxxxxxxx3B7r9o3h7f2xxxxxxxxxxxxl+tH2+l3wDQR3"
                }
            ]
        }
    ]
}
输出示例
{}
﻿

参数名称	必选	参数类型	参数描述
meeting_id	是	String	会议 ID。
layout_id	是	String	布局 ID。
userid	是	String	会议创建者 ID。
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
page_list	是	PageList 对象数组	布局单页对象列表。
enable_set_default	否	Boolean	是否设置为会议应用的布局，默认不设置。

状态码	错误码	错误描述
400	20012	不存在的布局 ID。
400	20020	会中非参会成员不得设置座次。
400	20011	会前非邀请成员不得设置座次。
400	190004	参数非法，请对照接口文档检查您的参数。
400	20027	不存在的布局模板 ID。
400	20028	不存在的布局宫格 ID。
500	202004	Oauth 鉴权时查询 secret 信息失败。
500	9042	没有权限。
500	960000	网络错误，请稍后重试。
500	9003	会议信息不存在。
500	190001	存在未注册的用户。
500	41	网络错误，请稍后重试。
500	13703	查询会议失败。

修改会议布局

本页目录：

接口描述

输入参数

PageList 对象

UserSeatList 对象

输出参数

错误码列表

示例

输入示例

输出示例