Name
QQ::exmail::group
DESCRIPTION
通讯录管理->管理邮件群组
FUNCTION
create(access_token, hash);
创建邮件群组
SYNOPSIS
https://exmail.qq.com/qy_mng_logic/doc#10022
请求说明:
请求包结构体为:
{
"groupid": "zhangsangroup@gzdev.com",
"groupname": "zhangsangroup ,
"userlist": ["zhangsanp@gzdev.com", "lisi@gzdev.com"],
"grouplist": ["group@gzdev.com"],
"department": [1, 2],
"allow_type": 4,
"allow_userlist": ["zhangsanp@gzdev.com"]
}
参数说明:
参数 必须 说明
access_token 是 调用接口凭证
groupid 是 邮件群组名称
groupname 是 邮件群组名称
userlist 否 成员帐号,userlist,grouplist,department至少一个。成员由userlist,grouplist,department共同组成
grouplist 否 成员邮件群组,userlist,grouplist,department至少一个。成员由userlist,grouplist,department共同组成
department 否 成员部门,userlist,grouplist,department至少一个。成员由userlist,grouplist,department共同组成
allow_type 是 群发权限。0: 企业成员, 1任何人, 2:组内成员,3:指定成员
allow_userlist 否 群发权限为指定成员时,需要指定成员
权限说明
系统应用须拥有邮件群组的写管理权限。
RETURN 返回结果
{
"errcode": 0,
"errmsg": "created"
}
RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
update(access_token, hash);
更新邮件群组
SYNOPSIS
https://exmail.qq.com/qy_mng_logic/doc#10023
请求说明:
请求包结构体为:
{
"groupid": "zhangsangroup@gzdev.com",
"groupname": "zhangsangroup",
"userlist": ["zhangsanp@gzdev.com","lisi@gzdev.com"],
"grouplist": ["group@gzdev.com"],
"department":[1,2],
"allow_type":3,
"allow_userlist":["zhangsanp@gzdev.com"]
}
参数说明:
参数 必须 说明
access_token 是 调用接口凭证
groupid 是 邮件群组id,邮件格式
groupname 否 邮件群组名称
userlist 否 成员帐号,userlist,grouplist,department至少一个。成员由userlist,grouplist,department共同组成
grouplist 否 成员邮件群组,userlist,grouplist,department至少一个。成员由userlist,grouplist,department共同组成
department 否 成员部门,userlist,grouplist,department至少一个。成员由userlist,grouplist,department共同组成
allow_type 否 群发权限。0: 企业成员,1任何人,2:组内成员,3:指定成员
allow_userlist 否 群发权限为指定成员时,需要指定成员
权限说明
系统应用须拥有邮件群组的写管理权限。
RETURN 返回结果
{
"errcode": 0,
"errmsg": "updated"
}
RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
delete(access_token, groupid);
删除邮件群组
SYNOPSIS
https://exmail.qq.com/qy_mng_logic/doc#10024
请求说明:
参数说明:
参数 必须 说明
access_token 是 调用接口凭证
groupid 是 邮件群组id,邮件格式
权限说明
系统应用须拥有邮件群组的写管理权限
RETURN 返回结果
{
"errcode": 0,
"errmsg": "deleted"
}
RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
get(access_token, groupid);
获取邮件群组信息
SYNOPSIS
https://exmail.qq.com/qy_mng_logic/doc#10025
请求说明:
参数说明:
参数 必须 说明
access_token 是 调用接口凭证
groupid 是 邮件群组id,邮件格式
权限说明
系统应用须拥有邮件群组的读权限
RETURN 返回结果
{
"errcode": 0,
"errmsg": "ok",
"groupid": "zhangsangroup@gzdev.com",
"groupname": "zhangsangroup",
"userlist": ["zhangsanp@gzdev.com", "lisi@gzdev.com"],
"grouplist": [" group@gzdev.com "],
"department": [1, 2],
"allow_type": 3,
"allow_userlist": ["zhangsanp@gzdev.com"]
}
RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
groupid 邮件群组id,邮件格式
groupname 邮件群组名称
userlist 成员帐号
grouplist 成员邮件群组
department 成员部门
allow_type 群发权限。0: 企业成员, 1任何人, 2:组内成员,3:指定成员
allow_userlist 群发权限为指定成员时,需要指定成员,否则赋值失效