接口描述
描述:对企业成员或部门进行会议,录制等相关功能进行设置。
请求方式:POST
鉴权方式:AK/SK 鉴权
自建应用权限点:操作人需具备人员/部门管理权限。
接口请求域名:
https://api.meeting.qq.com/v1/crop/modify-user-settings
输入参数
请求体
参数名称 | 必填 | 参数类型 | 参数描述 |
operator_id | 是 | string | 操作者 ID。 说明:operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 企业唯一用户标识说明: 1:企业对接 SSO 时使用的员工唯一标识 ID。 2:企业调用创建用户接口时传递的 userid 参数。 |
operator_id_type | 是 | integer | 操作者 ID 类型。 1:userid |
to_operator_id | 否 | string | 被操作的用户 ID。 说明:to_operator_id 必须与 to_operator_id_type 配合使用。根据 to_operator_id_type 的值,to_operator_id 代表不同类型。 企业唯一用户标识说明: 1:企业对接 SSO 时使用的员工唯一标识 ID。 2:企业调用创建用户接口时传递的 userid 参数。 |
to_operator_id_type | 否 | integer | 被操作者 ID 类型。 1:userid |
to_department_id | 否 | string | 被操作的部门 ID。 |
setting_type | 是 | integer | 设置操作对象类型。 1:用户 2:部门 说明: 值为1时,to_operator_id、to_operator_id_type 不能为空。 值为2时,to_department_id 不能为空。 |
setting_items | 是 | 设置列表。 说明: 多条设置项目将按先后顺序逐一执行,如果多条设置项中存在重复/冲突的项目,位置靠后的设置将覆盖位置靠前的设置。 |
SettingItem 对象数组
参数名称 | 必填 | 参数类型 | 参数描述 |
item_name | 是 | string | 需要设置的项目名。 说明: |
item_value | 是 | string | 需要设置的值。 说明: Boolean 类型设置项,转换为字符串 “0” / “1” 进行设置。 数值型设置项,转换为 string 进行设置。 |
可设置的项目列表
配置项(item_name) | 含义 | 取值 | 补充说明 |
config.meeting.ai_assistant | AI 小助手 | 1:开启 2:关闭 | - |
config.meeting.ai_summary | AI 纪要 | 1:开启 2:关闭 | “AI 托管”功能依赖“AI 纪要”。“AI 纪要”关闭时“AI 托管”将自动关闭。 |
config.meeting.ai_summary_autostart | 入会自动开启 AI 纪要 | 1:开启 2:关闭 | - |
config.meeting.ai_host_comment | AI 托管 | 1:开启 2:关闭 | “AI 托管”功能依赖“AI 纪要”。“AI 托管”打开时“AI 纪要”将自动打开。 |
config.record.local_record | 本地录制 | 1:开启 2:关闭 | - |
config.record.cloud_record | 云录制 | 1:开启 2:关闭 | “云录制”关闭时,“同时录制音频文件”、“同时开启录制转写”、“同时启用智能录制”将自动关闭。 |
config.record.cloud_record_audio | 同时录制音频文件 | 1:开启 2:关闭 | “同时录制音频文件”打开时,“云录制”将自动打开。 |
config.record.transcript | 同时开启录制转写 | 1:开启 2:关闭 | “同时开启录制转写”打开时,“云录制”将自动打开。 “同时开启录制转写”关闭时,“同时开启智能录制”、“开启智能录制基本功能”、“开启智能录制高级功能”将自动关闭。 |
config.record.intelligent_recording | 同时开启智能录制 | 1:开启 2:关闭 | “同时开启智能录制”打开时,“云录制”、“同时开启录制转写”、“开启智能录制基本功能”、“开启智能录制高级功能”将自动打开。 “同时开启智能录制”关闭时,“开启智能录制基本功能”、“开启智能录制高级功能”将自动关闭。 |
config.record.intelligent_recording_base_function | 开启智能录制基本功能 | 1:开启 2:关闭 | “开启智能录制基本功能”打开时,“同时开启智能录制”将自动打开。 “开启智能录制基本功能”、“开启智能录制高级功能”都关闭时,“同时开启智能录制”将自动关闭。 |
config.record.intelligent_recording_advanced_function | 开启智能录制高级功能 | 1:开启 2:关闭 | “开启智能录制高级功能”打开时,“同时开启智能录制”将自动打开。 “开启智能录制基本功能”、“开启智能录制高级功能”都关闭时,“同时开启智能录制”将自动关闭。 |
输出参数
错误码列表
状态码 | 错误码 | 错误描述 |
500 | 9042 | 权限受限或鉴权失败。 |
500 | 500229 | 该配置项已被企业锁定。 |
500 | 500230 | 设置的用户不存在。 |
500 | 190004 | 设置的部门不存在。 |
400 | 190004 | 参数格式非法,或缺少必要参数。请对照接口文档检查您的参数。 |