更新邮件群组

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

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

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

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

权限说明

自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）

应用调用接口只能访问自身创建的邮件群组

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/exmail/group/update' \ --header 'Content-Type: application/json' \ --data-raw '{ "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] } }'

请求参数

Query 参数

access_token

string

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

groupid

string

必需

邮件群组ID，邮箱格式

groupname

string

必需

邮件群组名称，不能与其他群组重名，长度限定64字节

email_list

object

可选

群组内成员邮箱地址，读取成员的biz_mail字段，不传则不变，传空则清空。成员由email_list，group_list，department_list，tag_list共同组成，不允许全部清空

list

array[string]

必需

tag_list

object

可选

群组内包含的标签ID，不传则不变，传空为清空

list

array[integer]

必需

department_list

object

可选

群组内包含的部门ID，不传则不变，传空为清空

list

array[integer]

必需

group_list

object

可选

群组内包含的群组邮箱ID，不传则不变，传空为清空

list

array[string]

必需

allow_type

integer

可选

群组使用权限。0: 企业成员, 1任何人， 2:组内成员，3:自定义成员。当值为0、1、2时，不得传入allow_emaillist，allow_departmentlist，allow_taglist。当值为3时，必须传入allow_emaillist，allow_departmentlist，allow_taglist至少一项。若不需更新则不传入参数。

allow_emaillist

object

可选

允许使用群组群发的成员邮箱地址，不传则不变，传空为清空

list

array[string]

必需

allow_departmentlist

object

可选

允许使用群组群发的部门ID，不传则不变，传空为清空

list

array[integer]

必需

allow_taglist

object

可选

允许使用群组群发的标签ID，不传则不变，传空为清空

list

array[integer]

必需

示例

请求参数

返回响应