08_用户管理之用户组管理

1.创建分组

1.1.接口说明

一个公众账号，最多支持创建100个分组。

1.2.调用接口（post方法）

https://api.weixin.qq.com/cgi-bin/groups/create?access_token=ACCESS_TOKEN

1.3.调用实例

{"group":{"name":"test"}}

1.4.参数说明

access_token：调用接口凭证

name：分组名字（30个字符以内）

1.5.返回说明

{
    "group": {
        "id": 107, 
        "name": "test"
    }
}

1.6.返回参数说明

id：分组id，由微信分配

name：分组名字，UTF8编码

1.7.返回错误说明

{"errcode":40013,"errmsg":"invalid appid"}

2.查询所有分组

2.1.调用接口(get方法)

https://api.weixin.qq.com/cgi-bin/groups/get?access_token=ACCESS_TOKEN

2.2.参数说明

access_token：调用接口凭证

2.3.返回说明

{
    "groups": [
        {
            "id": 0, 
            "name": "未分组", 
            "count": 72596
        }, 
        {
            "id": 1, 
            "name": "黑名单", 
            "count": 36
        }, 
        {
            "id": 2, 
            "name": "星标组", 
            "count": 8
        }, 
        {
            "id": 104, 
            "name": "华东媒", 
            "count": 4
        }, 
        {
            "id": 106, 
            "name": "★不测试组★", 
            "count": 1
        }
    ]
}

2.4.返回参数说明

groups：公众平台分组信息列表

id：分组id，由微信分配

name：分组名字，UTF8编码

count：分组内用户数量

2.5.返回错误说明

{"errcode":40013,"errmsg":"invalid appid"}

3.查询用户所在分组

3.1.接口说明

通过用户的OpenID查询其所在的GroupID。

3.2.调用接口（post方法，https协议）

https://api.weixin.qq.com/cgi-bin/groups/getid?access_token=ACCESS_TOKEN

3.3.调用实例

{"openid":"od8XIjsmk6QdVTETa9jLtGWA6KBc"}

3.4.参数说明

access_token：调用接口凭证

openid：用户的OpenID

3.5.返回说明

{"groupid": 102}

3.6.返回参数说明

groupid：用户所属的groupid

3.7.返回错误说明

{"errcode":40003,"errmsg":"invalid openid"}

4.修改分组名

4.1.调用接口（post方法）

https://api.weixin.qq.com/cgi-bin/groups/update?access_token=ACCESS_TOKEN

4.2.调用实例

{"group":{"id":108,"name":"test2_modify2"}}

4.3.参数说明

access_token：调用接口凭证

id：分组id，由微信分配

name：分组名字（30个字符以内）

4.4.返回正确说明

{"errcode": 0, "errmsg": "ok"}

4.5.返回错误说明

{"errcode":40013,"errmsg":"invalid appid"}

5.移动用户分组

5.1.调用接口（post方法）

https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token=ACCESS_TOKEN

5.2.调用实例

{"openid":"oDF3iYx0ro3_7jD4HFRDfrjdCM58","to_groupid":108}

5.3.参数说明

access_token：调用接口凭证

openid：用户唯一标识符

to_groupid：分组id

5.4.返回正确说明

{"errcode": 0, "errmsg": "ok"}

5.5.返回错误说明

{"errcode":40013,"errmsg":"invalid appid"}

6.批量移除用户分组

6.1.调用接口

https://api.weixin.qq.com/cgi-bin/groups/members/batchupdate?access_token=ACCESS_TOKEN

6.2.调用实例

{"openid_list":["oDF3iYx0ro3_7jD4HFRDfrjdCM58","oDF3iY9FGSSRHom3B-0w5j4jlEyY"],"to_groupid":108}

6.3.参数说明

access_token：调用接口凭证

openid_list：用户唯一标识符openid的列表（size不能超过50）

to_groupid：分组id

6.4.返回正确说明

{"errcode": 0, "errmsg": "ok"}

6.5.返回错误说明

{"errcode":40013,"errmsg":"invalid appid"}

7.删除分组

7.1.接口说明

注意本接口是删除一个用户分组，删除分组后，所有该分组内的用户自动进入默认分组。

7.2.调用接口

https://api.weixin.qq.com/cgi-bin/groups/delete?access_token=ACCESS_TOKEN

7.3.调用实例

{"group":{"id":108}}

7.4.参数说明

access_token：调用接口凭证

group：分组

id：分组的id

7.5.返回正确说明

{"errcode": 0, "errmsg": "ok"}

7.6.返回错误说明

{"errcode":40013,"errmsg":"invalid appid"}

08_用户管理之用户组管理

猜你喜欢