The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
QQ-exmail-1.10
River stage zero No dependents
1 ++
/ QQ::exmail::group

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