修改部门/个人配置项

最近更新时间:2026-01-08 15:46:22

我的收藏

接口描述

描述:对企业成员或部门进行会议,录制等相关功能进行设置。
请求方式: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
参数格式非法,或缺少必要参数。请对照接口文档检查您的参数。