企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
邮件
管理公共邮箱
更新公共邮箱
更新公共邮箱
最后更新:2024/09/12

该接口用于更新公共邮箱,支持更新名称、使用权限。需要注意的是Json数组类型传空值将会清空其内容,不传则保持不变。
例如清空userid_list:

{
  "id": 1,
  "name": "apitest",
  "userid_list" : {"list" : []}
}

若需保持不变则不传即可:

{
  "id": 1,
  "name": "apitest"
}

 

请求方式:POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/exmail/publicmail/update?access_token=ACCESS_TOKEN

请求包体

{
  "id" : 1,
  "name": "apitest",
  "userid_list": {
    "list": ["apitest1", "apitest2"]
  },
  "department_list": {
    "list": [1, 2]
  },
  "tag_list": {
    "list": [1, 2]
  },
  "create_auth_code": 1,
  "auth_code_info" : {
    "remark": "客户端专用密码备注"
  }
}

参数说明

参数类型是否必须说明
iduint32公共邮箱ID
namestring公共邮箱名称,不多于64个字符或32个汉字,不得与其他公共邮箱重名
userid_liststring有权限使用公共邮箱的成员UserID列表,不传则不变,传空为清空。userid_list、department_list、taglist不能同时为空,(使用成员不允许全部清空)
department_listuint32有权限使用公共邮箱的部门列表,不传则不变,传空为清空
tag_listuint32有权限使用公共邮箱的标签列表,不传则不变,传空为清空
create_auth_codeuint32是否创建客户端专用密码,0表示否,1表示是,默认0。一个公共邮箱通过API接口创建的客户端专用密码不能超过10个(不包括已删除的),客户端专用密码只会显示一次,请在客户端中输入该密码进行验证,每次生成的密码皆可使用,请勿告诉他人
auth_code_info.remarkstring创建客户端专用密码的备注,仅当设置create_auth_code=1时有效。创建客户端专用密码时未设置备注则默认为"办公PC", 最长不超过128个字节,必须是utf8编码

权限说明

 

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "auth_code_id" : 1,
    "auth_code" : "AUTH_CODE"
}

参数说明

参数类型说明
errcodeint32错误码
errmsgstring错误码说明
auth_code_iduint32客户端专用密码ID,仅当设置创建客户端专用密码的时候返回,后续可通过接口删除客户端专用密码
auth_codestring客户端专用密码, 仅当设置创建客户端专用密码的时候返回,该客户端专用密码仅会返回一次,请妥善存储
上一篇创建公共邮箱
下一篇删除公共邮箱
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们