获取部门/个人配置项

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

我的收藏

接口描述

描述:获取企业成员或部门的会议/录制等相关功能配置。
请求方式:POST
鉴权方式:AK/SK 鉴权
自建应用权限点:操作人需具备人员/部门管理权限。
接口请求域名
https://api.meeting.qq.com/v1/crop/get-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_names
string 对象数组
需获取的设置列表。

输出参数

参数名称
参数类型
参数描述
setting_items
用户/部门设置列表。

SettingItem 对象数组

参数名称
参数类型
参数描述
item_name
string
设置项目名。
说明:
设置项目明细,参见 修改部门/个人配置项可设置的项目列表
item_value
string
设置项目的数值。
说明:
Boolean 类型设置项,转换为字符串 “0” / “1” 进行设置。
数值型设置项,转换为 string 进行设置。
from_type
integer
设置项值的来源。
0:未定义
1:来源于默认值
2:来源于企业全局设置
3:来源于针对个人/部门的设置
4:来源于父部门的设置
说明:
用于追踪配置来源。
from_department_id
string
当设置项值来源于父部门时,父部门的部门 ID。
value_type
string
设置项数据类型,支持 “number”、“string”、“bool”、“object”、“array”。

错误码列表

状态码
错误码
错误描述
500
9042
权限受限或鉴权失败。
500
500230
查询的用户不存在。
500
190004
设置的部门不存在。
400
190004
参数格式非法,或缺少必要参数。请对照接口文档检查您的参数。