用户管理-用户分组管理

微笑天使

开发者可以使用接口，对公众平台的分组进行查询、创建、修改、删除等操作，也可以使用接口在需要时移动用户到某个分组。

目录 1 创建分组 2 查询所有分组 3 查询用户所在分组 4 修改分组名 5 移动用户分组 6 批量移动用户分组 7 删除分组

创建分组一个公众账号，最多支持创建100个分组。
接口调用请求说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/groups/create?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{"group":{"name":"test"}}参数说明

参数	说明
access_token	调用接口凭证
name	分组名字（30个字符以内）

返回说明正常时的返回JSON数据包示例：
{    "group": {        "id": 107,         "name": "test"    }}参数说明

参数	说明
id	分组id，由微信分配
name	分组名字，UTF8编码

错误时的JSON数据包示例（该示例为AppID无效错误）：
{"errcode":40013,"errmsg":"invalid appid"}全局返回码说明
使用网页调试工具调试该接口
查询所有分组接口调用请求说明
http请求方式: GET（请使用https协议）https://api.weixin.qq.com/cgi-bin/groups/get?access_token=ACCESS_TOKEN参数说明

参数	说明
access_token	调用接口凭证

返回说明正常时的返回JSON数据包示例：
{    "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        }    ]}参数说明

参数	说明
groups	公众平台分组信息列表
id	分组id，由微信分配
name	分组名字，UTF8编码
count	分组内用户数量

错误时的JSON数据包示例（该示例为AppID无效错误）：
{"errcode":40013,"errmsg":"invalid appid"}全局返回码说明
使用网页调试工具调试该接口
查询用户所在分组通过用户的OpenID查询其所在的GroupID。接口调用请求说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/groups/getid?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{"openid":"od8XIjsmk6QdVTETa9jLtGWA6KBc"}参数说明

参数	说明
access_token	调用接口凭证
openid	用户的OpenID

返回说明正常时的返回JSON数据包示例：
{    "groupid": 102}参数说明

参数	说明
groupid	用户所属的groupid

错误时的JSON数据包示例（该示例为OpenID无效错误）：
{"errcode":40003,"errmsg":"invalid openid"}全局返回码说明
使用网页调试工具调试该接口
修改分组名接口调用请求说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/groups/update?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{"group":{"id":108,"name":"test2_modify2"}}参数说明

参数	说明
access_token	调用接口凭证
id	分组id，由微信分配
name	分组名字（30个字符以内）

返回说明正常时的返回JSON数据包示例：
{"errcode": 0, "errmsg": "ok"}错误时的JSON数据包示例（该示例为AppID无效错误）：
{"errcode":40013,"errmsg":"invalid appid"}全局返回码说明
使用网页调试工具调试该接口
移动用户分组接口调用请求说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{"openid":"oDF3iYx0ro3_7jD4HFRDfrjdCM58","to_groupid":108}参数说明

参数	说明
access_token	调用接口凭证
openid	用户唯一标识符
to_groupid	分组id

返回说明正常时的返回JSON数据包示例：
{"errcode": 0, "errmsg": "ok"}错误时的JSON数据包示例（该示例为AppID无效错误）：
{"errcode":40013,"errmsg":"invalid appid"}全局返回码说明
使用网页调试工具调试该接口

批量移动用户分组接口调用请求说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/groups/members/batchupdate?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{"openid_list":["oDF3iYx0ro3_7jD4HFRDfrjdCM58","oDF3iY9FGSSRHom3B-0w5j4jlEyY"],"to_groupid":108}参数说明

参数	说明
access_token	调用接口凭证
openid_list	用户唯一标识符openid的列表（size不能超过50）
to_groupid	分组id

返回说明正常时的返回JSON数据包示例：
{"errcode": 0, "errmsg": "ok"}错误时的JSON数据包示例（该示例为AppID无效错误）：
{"errcode":40013,"errmsg":"invalid appid"}全局返回码说明
使用网页调试工具调试该接口

删除分组注意本接口是删除一个用户分组，删除分组后，所有该分组内的用户自动进入默认分组。接口调用请求说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/groups/delete?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{"group":{"id":108}}参数说明

参数	说明
access_token	调用接口凭证
group	分组
id	分组的id

返回说明正常时的返回JSON数据包示例：
{"errcode": 0, "errmsg": "ok"}错误时的JSON数据包示例（该示例为AppID无效错误）：
{"errcode":40013,"errmsg":"invalid appid"}全局返回码说明