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