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	群发权限为指定成员时,需要指定成员,否则赋值失效