更新邮件群组
请求说明:
HTTPS请求方式: POST
请求地址: https://api.exmail.qq.com/cgi-bin/group/update?access_token=ACCESS_TOKEN
请求包结构体为:
{
"groupid": "zhangsangroup@gzdev.com",
"groupname": "zhangsangroup",
"userlist": ["zhangsanp@gzdev.com","lisi@gzdev.com"],
"taglist": [2,5],
"department": [1,2],
"grouplist":["aaa@gzdev.com"],
"allow_type":3,
"allow_userlist":["zhangsanp@gzdev.com"],
"allow_department":[1630648871374,1630248871372],
"allow_taglist":[1,3]
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
groupid | 是 | 邮件群组id,邮件格式 |
groupname | 否 | 邮件群组名称 |
userlist | 否 | 成员帐号,不传入时不做改变。如有传入将会被覆盖更新为传入的值,成员由userlist,grouplist,department,taglist共同组成。例如传入userlist和taglist,那么权限成员将会被覆盖成userlist+taglist中的内容。 |
taglist | 否 | 标签成员,不传入时不做改变。如有传入将会被覆盖更新为传入的值。 |
grouplist | 否 | 邮件群组账号。不传入时不做改变。如有传入将会被覆盖更新为传入的值。 |
department | 否 | 部门帐号,不传入时不做改变。如有传入将会被覆盖更新为传入的值。 |
allow_type | 否 | 群发权限。0: 企业成员, 1任何人, 2:组内成员,3:自定义成员。不传入则不做改变。传入0/1/2将会清空原权限成员,并更新权限为0/1/2。传入3时,若不传入allow_userlist,allow_department,allow_taglist也不会改变原先权限设定。 |
allow_userlist | 否 | 设置群发权限成员 |
allow_department | 否 | 设置群发权限部门 |
allow_taglist | 否 | 设置群发权限标签 |
权限说明
系统应用须拥有邮件群组的写管理权限。
返回结果
{
"errcode": 0,
"errmsg": "created"
"invalid_userlist": [],
"invalid_departlist": [],
"invalid_taglist": [],
"invalid_grouplist":[]
}
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
invalid_userlist | 所有非法的user账号 |
invalid_departlist | 所有非法的部门ID |
invalid_taglist | 所有非法的标签ID |
invalid_grouplist | 所有非法的邮件群组ID |