添加录制访问成员

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

我的收藏

接口描述

描述:仅会议创建者、企业超级管理员或企业角色有录制管理权限的用户可调用,支持添加参会成员或企业内成员为录制访问成员,并设置仅查看权限或可管理权限。
请求方式: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
网络超时。

示例

输入示例

POST
https://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":[]
}