腾讯会议更新用户-开放平台文档-文档中心-腾讯云

通过 userid 更新用户
接口描述
描述：
使用 userid 更新企业用户，目前暂不支持 OAuth2.0 鉴权访问。
用户已删除或被禁用则不能更新。
不支持企微企业用户的更新。
请求方式：PUT
自建应用权限点：管理企业用户。
接口操作者权限点：需具备用户列表的编辑权限，可登录 管理后台 通过如下路径查看：用户管理 > 用户列表 > 编辑权限。
接口请求域名：
https://api.meeting.qq.com/v1/users/{userid}
﻿
输入参数
以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
email
否
String
邮箱地址，已激活的用户邮箱不可修改。
area
否
String
地区编码（默认值为86）。
username
否
String
新的用户昵称。
phone
否
String
手机号码，已激活的用户手机号码不可修改。
userid
否
String
调用方用于标示用户的唯一 ID。
企业唯一用户标识说明：企业调用创建用户接口时传递的 userid 参数。
avatar_url
否
String
头像地址。
staff_id
否
String
员工工号。
job_title
否
String
员工职位，长度范围为[0,96]个字符。
entry_time
否
Integer
入职时间。
department_list
否
String 数组
员工部门 ID，暂只支持为用户分配1个部门。
user_account_type
否
Integer
账号类型。
1：高级账号（企业版/教育版）
2：免费账号（企业版，教育版，商业版）
3：免费账号100方 （商业版）
4：高级账号300方（商业版）
5：高级账号500方（商业版）
6：高级账号1000方（商业版）
7：高级账号2000方（商业版）
8：高级账号100方（商业版）
注意：
根据传入的参数判断是否有该类型账号，没有则报错。更新后，原类型账号资源释放。
operator_id
是
String
操作者 ID。
operator_id_type
是
Integer
操作者 ID 类型。
1：userid
输出参数
无输出参数，成功返回空消息体，失败返回 错误码 和错误信息。
错误码列表
状态码
错误码
错误描述
500
156011
更新用户中，请勿重复提交。
500
20014
图片大小非法。
500
500025
版本不匹配。
400
500014
账号无权限。
500
20029
图片访问失败，请稍后重试。
500
20002
用户 userid 已存在。
400
190004
参数非法，请对照接口文档检查您的参数。
500
20013
图片 URL 非法。
500
20006
手机号格式错误。
500
20015
图片格式非法。
400
20001
用户不存在。
500
20016
图片尺寸过大。
示例
输入示例
PUT https://api.meeting.qq.com/v1/users/9527
{
  "username": "testusername",
  "operator_id":"KM4Ss4Th09ogUw1JiK",
  "operator_id_type":1
}
输出示例
更新用户成功，返回 Body 为空。
通过 uuid 更新用户
接口描述
描述：
通过 uuid 更新企业用户，目前暂不支持 OAuth2.0 鉴权访问。
用户已删除或被禁用则不能更新。
不支持企微企业用户的更新。
请求方式：PUT
自建应用权限点：管理企业用户。
接口请求域名：
https://api.meeting.qq.com/v1/users?uuid={uuid}
﻿
输入参数
以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
uuid
是
String
uuid（路径参数）。
email
否
String
邮箱地址，已激活的用户邮箱不可修改。
username
否
String
新的用户昵称。
phone
否
String
手机号码，已激活的用户手机号码不可修改。
avatar_url
否
String
头像地址。
staff_id
否
String
员工工号。
job_title
否
String
员工职位，长度范围为[0,96]个字符。
entry_time
否
Integer
入职时间。
department_list
否
String 数组
员工部门 ID，暂只支持为用户分配1个部门。
operator_id
是
String
操作者 ID。
operator_id_type
是
Integer
操作者 ID 类型。
1：userid
输出参数
无输出参数，成功返回空消息体，失败返回 错误码 和错误信息。
示例
输入示例
PUT https://api.meeting.qq.com/v1/users?uuid=WM4Fs4Th56ogU13JiK
{
  "username": "testusername",
  "operator_id":"KM4Ss4Th09ogUw1JiK",
  "operator_id_type":1
}
﻿
输出示例
更新用户成功，返回 Body 为空。

参数名称	必选	参数类型	参数描述
email	否	String	邮箱地址，已激活的用户邮箱不可修改。
area	否	String	地区编码（默认值为86）。
username	否	String	新的用户昵称。
phone	否	String	手机号码，已激活的用户手机号码不可修改。
userid	否	String	调用方用于标示用户的唯一 ID。企业唯一用户标识说明：企业调用创建用户接口时传递的 userid 参数。
avatar_url	否	String	头像地址。
staff_id	否	String	员工工号。
job_title	否	String	员工职位，长度范围为[0,96]个字符。
entry_time	否	Integer	入职时间。
department_list	否	String 数组	员工部门 ID，暂只支持为用户分配1个部门。
user_account_type	否	Integer	账号类型。 1：高级账号（企业版/教育版） 2：免费账号（企业版，教育版，商业版） 3：免费账号100方（商业版） 4：高级账号300方（商业版） 5：高级账号500方（商业版） 6：高级账号1000方（商业版） 7：高级账号2000方（商业版） 8：高级账号100方（商业版）注意：根据传入的参数判断是否有该类型账号，没有则报错。更新后，原类型账号资源释放。
operator_id	是	String	操作者 ID。
operator_id_type	是	Integer	操作者 ID 类型。 1：userid

状态码	错误码	错误描述
500	156011	更新用户中，请勿重复提交。
500	20014	图片大小非法。
500	500025	版本不匹配。
400	500014	账号无权限。
500	20029	图片访问失败，请稍后重试。
500	20002	用户 userid 已存在。
400	190004	参数非法，请对照接口文档检查您的参数。
500	20013	图片 URL 非法。
500	20006	手机号格式错误。
500	20015	图片格式非法。
400	20001	用户不存在。
500	20016	图片尺寸过大。

更新用户

本页目录：

通过 userid 更新用户

接口描述

输入参数

输出参数

错误码列表

示例

输入示例

输出示例

通过 uuid 更新用户

接口描述

输入参数

输出参数

示例

输入示例

输出示例