接口描述
描述:仅会议创建者、企业超级管理员或企业角色有录制管理权限的用户可调用,支持添加参会成员或企业内成员为录制访问成员,并设置仅查看权限或可管理权限。
请求方式:POST
鉴权:JWT,OAuth2.0
权限点:管理会议录制
接口请求域名:
https://api.meeting.qq.com/v1/records/access/{meeting_record_id}
路径参数
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_record_id | 是 | String | 会议录制 ID。 |
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
operator_id | 是 | String | 操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 |
operator_id_type | 是 | Integer | 操作者 ID 的类型: 1:userid 2:open_id |
access_members | 是 | AccessMember 对象数组 | 成员列表,一次最多传入200个,可以多次调用接口,累加型接口。 |
AccessMember 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
to_operator_id_type | 是 | Integer | 被操作者 ID 类型,只支持设置参会成员或企业内成员。 1:userid 2:open_id 4:ms_open_id |
to_operator_id | 是 | String | 被操作者 ID,根据 to_operator_id_type 的值,使用不同的类型。 |
permission | 否 | Integer | 成员访问权限,默认为 0: 0:仅查看 1:可管理 |
输出参数
参数名称 | 必选 | 参数类型 | 参数描述 |
fail_access_members | 是 | AccessMember 对象数组 | 未添加成功的对象列表。 |
AccessMember 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
to_operator_id_type | 是 | Integer | 被操作者 ID 类型,需要同企业或参会成员。 1:userid 2:open_id 4:ms_open_id |
to_operator_id | 是 | String | 被操作者 ID,根据 to_operator_id_type 的值,使用不同的类型。 |
permission | 否 | Integer | 成员访问权限,默认为 0: 0:仅查看 1:可管理 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
400 | 41 | 网络超时。 |
示例
输入示例
POSThttps://api.meeting.qq.com/v1/records/access/12345678{"operator_id": "test","operator_id_type": 1,"access_members": [{"to_operator_id_type": 1,"to_operator_id": "user1"},{"to_operator_id_type":1,"to_operator_id":"user2"}]}
输出示例
{"fail_access_members":[]}