微信公众平台开发(88) 用户分组接口

本文介绍在微信公众平台上如何使用高级接口开发用户分组接口的功能。

 

一、接口介绍

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

一个公众账号，最多支持创建500个分组。 接口调用请求说明创建分组

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"}

创建分组程序实现

$access_token = "";$data = '{"group": {"name": "老师"}}';$url = "https://api.weixin.qq.com/cgi-bin/groups/create?access_token=$access_token";$result = https_request($url, $data);$jsoninfo = json_decode($result, true);var_dump($result);

执行结果如下：

{    "group": {        "id": 100,        "name": "老师"    }}

 

查询所有分组

接口调用请求说明

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"}

 程序实现：

$url = "https://api.weixin.qq.com/cgi-bin/groups/get?access_token=$access_token";$result = https_request($url);var_dump($result); 

 

查询用户所在分组

通过用户的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"}

 

 

 

====================================================================

方倍工作室微信公众平台账号关注方法：
1. 微信通讯录-添加朋友-查找公众号-搜索“方倍工作室”
2. 微信通讯录-添加朋友-搜号码-输入“pondbaystudio”
3. 使用微信扫描下面的二维码