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

该接口用于更新邮件群组,可以修改群组名称、群组成员、群组使用权限等。需要注意的是Json数组类型传空值将会清空其内容,不传则保持不变。
例如清空email_list:

{
  "groupid": "zhangsangroup@gzdev.com",
  "groupname": "zhangsangroup",
  "email_list" : {"list" : []}
}

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

{
  "groupid": "zhangsangroup@gzdev.com",
  "groupname": "zhangsangroup"
}

 

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

请求包体

{
  "groupid": "zhangsangroup@gzdev.com",
  "groupname": "zhangsangroup",
  "email_list": {
    "list": ["lisi@gzdev.com", "wangwu@gzdev.com"]
  },
  "tag_list": {
    "list": [2, 5]
  },
  "department_list": {
    "list": [1, 2]
  },
  "group_list": {
    "list": ["aaa@gzdev.com"]
  },
  "allow_type": 3,
  "allow_emaillist": {
    "list": ["zhangsanp@gzdev.com"]
  },
  "allow_departmentlist": {
    "list": [1, 2]
  },
  "allow_taglist": {
    "list": [1, 3]
  }
}

参数说明

参数类型是否必须说明
groupidstring邮件群组ID,邮箱格式
groupnamestring邮件群组名称,不能与其他群组重名,长度限定64字节
email_liststring群组内成员邮箱地址,读取成员的biz_mail字段,不传则不变,传空则清空。成员由email_list,group_list,department_list,tag_list共同组成,不允许全部清空
tag_listuint32群组内包含的标签ID,不传则不变,传空为清空
department_listuint32群组内包含的部门ID,不传则不变,传空为清空
group_liststring群组内包含的群组邮箱ID,不传则不变,传空为清空
allow_typeuint32群组使用权限。0: 企业成员, 1任何人, 2:组内成员,3:自定义成员。当值为0、1、2时,不得传入allow_emaillist,allow_departmentlist,allow_taglist。当值为3时,必须传入allow_emaillist,allow_departmentlist,allow_taglist至少一项。若不需更新则不传入参数。
allow_emailliststring允许使用群组群发的成员邮箱地址,不传则不变,传空为清空
allow_departmentlistuint32允许使用群组群发的部门ID,不传则不变,传空为清空
allow_taglistuint32允许使用群组群发的标签ID,不传则不变,传空为清空

权限说明

 

返回示例

{
   "errcode": 0,
   "errmsg": "ok"
}

参数说明

参数类型说明
errcodeint32错误码
errmsgstring错误码说明
上一篇创建邮件群组
下一篇删除邮件群组
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们