Java微信公众号开发之标签管理、分组管理（全）

最新推荐文章于 2024-07-24 16:29:50 发布
最新推荐文章于 2024-07-24 16:29:50 发布
阅读量6.9k 收藏 12
点赞数
分类专栏： 微信开发(JAVA) 文章标签： 微信 分组 标签 开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u011752195/article/details/81782526
版权

用户标签（分组）管理

开发者可以使用用户标签管理的相关接口，实现对公众号的标签进行创建、查询、修改、删除等操作，也可以对用户进行打标签、取消标签等操作。

注意：标签管理即分组管理，把url里面的tags换成groups的效果一样。

 

1. 创建标签

一个公众号，最多可以创建100个标签。

接口调用请求说明

http请求方式：POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/tags/create?access_token=ACCESS_TOKEN

POST数据格式：JSON 
POST数据示例：

{   "tag" : {     "name" : "广东"//标签名   } }

参数说明

参数说明
access_token调用接口凭据
name标签名（30个字符以内）

返回说明（正常时返回的json数据包示例）

{   "tag":{ "id":134,//标签id "name":"广东"   } }

返回参数说明

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

错误码说明

错误码说明
-1系统繁忙
45157标签名非法，请注意不能和其他标签重名
45158标签名长度超过30个字节
45056创建的标签数过多，请注意不能超过100个

 创建分组程序Java实现代码：

	/**
     * 创建群组
     * @param appId
     * @param appSecret
     * @param groupName 群组名称
     * @return 如{"group": { "id": 107, "name": "test" } }
     */
	public static JSONObject createGroup(String appId, String appSecret, String groupName){
		String url = "https://api.weixin.qq.com/cgi-bin/groups/create?access_token=" + AccessTokenInfo.accessToken.getAccessToken();
		JSONObject j = new JSONObject();
		JSONObject group = new JSONObject();
		try {
			j.put("name",groupName);
            group.put("group",j);
		} catch (JSONException e) {
			e.printStackTrace();
		}
		
		String rtn = weixinRequest(url, group.toString(), "POST");
		System.out.println("创建群组："+rtn);
		JSONObject json;
		try {
			json = new JSONObject(JSON.parseObject(rtn));
		} catch (JSONException e) {
			throw new RuntimeException(e.getMessage(),e);
		}
		return json;
	}

2. 获取公众号已创建的标签

接口调用请求说明

http请求方式：GET（请使用https协议） 
https://api.weixin.qq.com/cgi-bin/tags/get?access_token=ACCESS_TOKEN

返回说明

{   "tags":[{       "id":1,       "name":"每天一罐可乐星人",       "count":0 //此标签下粉丝数 },{   "id":2,   "name":"星标组",   "count":0 },{   "id":127,   "name":"广东",   "count":5 }   ] }

 查询所有分组程序Java实现代码：

    /**
     * 查询所有分组
     * @param appId
     * @param appSecret
     * @return
     */
    public static JSONObject getAllGroups(String appId, String appSecret){
        String url = "https://api.weixin.qq.com/cgi-bin/groups/get?access_token=" + AccessTokenInfo.accessToken.getAccessToken();
        //https://api.weixin.qq.com/cgi-bin/tags/get?access_token=ACCESS_TOKEN
        String rtn = weixinRequest(url, null, "GET");
        System.out.println("分组信息："+rtn);
        JSONObject json;
        try {
            json = new JSONObject(JSON.parseObject(rtn));
        } catch (JSONException e) {
            throw new RuntimeException(e.getMessage(),e);
        }
        return json;
    }

3. 编辑标签

接口调用请求说明

http请求方式：POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/tags/update?access_token=ACCESS_TOKEN

POST数据格式：JSON 
POST数据例子：

{   "tag" : {     "id" : 134,     "name" : "广东人"   } }

返回说明

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

错误码说明

错误码说明
-1系统繁忙
45157标签名非法，请注意不能和其他标签重名
45158标签名长度超过30个字节
45058不能修改0/1/2这三个系统默认保留的标签

编辑标签程序Java实现代码： 

    /**
     * 修改分组名
     * @param appId
     * @param appSecret
     * @param groupId
     * @param newGroupName
     * @return 如 {"errcode": 0, "errmsg": "ok"}
     */
    public static JSONObject updateGroup(String appId, String appSecret, String groupId, String newGroupName){
        String url = "https://api.weixin.qq.com/cgi-bin/groups/update?access_token=" + AccessTokenInfo.accessToken.getAccessToken();
        JSONObject j = new JSONObject();
        JSONObject group = new JSONObject();
        try {
            j.put("id", groupId);
            j.put("name",newGroupName);
            group.put("group",j);
        } catch (JSONException e) {
            e.printStackTrace();
        }
       
        String rtn = weixinRequest(url, group.toString(), "POST");
        System.out.println("修改分组名:"+rtn);
        JSONObject json;
        try {
            json = new JSONObject(JSON.parseObject(rtn));
        } catch (JSONException e) {
            throw new RuntimeException(e.getMessage(),e);
        }
        return json;
    }

4. 删除标签

请注意，当某个标签下的粉丝超过10w时，后台不可直接删除标签。此时，开发者可以对该标签下的openid列表，先进行取消标签的操作，直到粉丝数不超过10w后，才可直接删除该标签。

接口调用请求说明

http请求方式：POST（请使用https协议） 
https://api.weixin.qq.com/cgi-bin/tags/delete?access_token=ACCESS_TOKEN

POST数据格式：JSON 
POST数据例子：

{   "tag":{        "id" : 134   } }

返回说明

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

错误码说明

错误码说明
-1系统繁忙
45058不能修改0/1/2这三个系统默认保留的标签
45057该标签下粉丝数超过10w，不允许直接删除

删除标签程序Java实现代码：  

	/**
     * 删除群组
     * @param appId
     * @param appSecret
     * @param groupName 群组名称
     * @return 如{"group": { "id": 107, "name": "test" } }
     */
	public static JSONObject deleteGroup(String appId, String appSecret, String groupName){
		String url = "https://api.weixin.qq.com/cgi-bin/groups/delete?access_token=" + AccessTokenInfo.accessToken.getAccessToken();
		JSONObject j = new JSONObject();
        JSONObject group = new JSONObject();
		try {
            j.put("id",groupName);
            group.put("group",j);
		} catch (JSONException e) {
			e.printStackTrace();
		}
		String rtn = weixinRequest(url, group.toString(), "POST");
		System.out.println("deleteGroup()"+rtn);
		JSONObject json;
		try {
			json = new JSONObject(JSON.parseObject(rtn));
		} catch (JSONException e) {
			throw new RuntimeException(e.getMessage(),e);
		}
		return json;
	}

5. 获取标签下粉丝列表

接口调用请求说明

http请求方式：GET（请使用https协议） 
https://api.weixin.qq.com/cgi-bin/user/tag/get?access_token=ACCESS_TOKEN

POST数据格式：JSON 
POST数据例子：

{   "tagid" : 134,   "next_openid":""//第一个拉取的OPENID，不填默认从头开始拉取 }

返回说明（正常时返回的json包示例）

{   "count":2,//这次获取的粉丝数量   
"data":{//粉丝列表
"openid":[  
"ocYxcuAEy30bX0NXmGn4ypqx3tI0",    
"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"  ]  
},  
"next_openid":"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"//拉取列表最后一个用户的openid 
}

错误码说明

错误码说明
-1系统繁忙
40003传入非法的openid
45159非法的tag_id

获取标签下粉丝列表程序Java实现代码：  

    /**
     * 获取分组下粉丝列表
     * @param appId
     * @param appSecret
     * @param id 分组id
     * @return 如 {"errcode": 0, "errmsg": "ok"}
     */
    public static JSONObject ListGroup(String appId, String appSecret, String id){
        String url = "https://api.weixin.qq.com/cgi-bin/user/tag/get?access_token=" + AccessTokenInfo.accessToken.getAccessToken();
        JSONObject j = new JSONObject();
        try {
        	j.put("tagid",id);
        } catch (JSONException e) {
            e.printStackTrace();
        }
       
        String rtn = weixinRequest(url, j.toString(), "GET");
        System.out.println("分组粉丝列表："+rtn);
        JSONObject json;
        try {
            json = new JSONObject(JSON.parseObject(rtn));
        } catch (JSONException e) {
            throw new RuntimeException(e.getMessage(),e);
        }
        return json;
    }

6.移动用户分组

接口调用请求说明

http请求方式: POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token=ACCESS_TOKEN
POST数据格式：json
POST数据例子：{"openid":"oDF3iYx0ro3_7jD4HFRDfrjdCM58","to_groupid":108}

参数说明

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

返回说明 正常时的返回JSON数据包示例：

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

错误时的JSON数据包示例（该示例为AppID无效错误）：

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

移动用户分组程序Java实现代码：

    /**
     * 移动用户分组
     * @param appId
     * @param appSecret
     * @param toGroupId 新分组的id
     * @param openId 用户id
     * @return 如 {"errcode": 0, "errmsg": "ok"}
     */
    public static JSONObject updateUserGroup(String appId, String appSecret, String toGroupId, String openId){
        String url = "https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token=" + AccessTokenInfo.accessToken.getAccessToken();
        JSONObject j = new JSONObject();
        try {
            j.put("openid", openId);
            j.put("to_groupid", toGroupId);
        } catch (JSONException e) {
            e.printStackTrace();
        }
       
        String rtn = weixinRequest(url, j.toString(), "POST");
        System.out.println("更新用户组："+rtn);
        JSONObject json;
        try {
            json = new JSONObject(JSON.parseObject(rtn));
        } catch (JSONException e) {
            throw new RuntimeException(e.getMessage(),e);
        }
        return json;
    }

 7. 通过ID获取用户身上的标签

接口调用请求说明

http请求方式：POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/groups/getid?access_token=ACCESS_TOKEN

POST数据格式：JSON 
POST数据例子：

{   "openid" : "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y" }

错误码说明

错误码说明
-1系统繁忙
40003传入非法的openid
49003传入的openid不属于此AppID

 获取用户身上的标签程序Java实现代码：  

    /**
     * 通过用户的OpenID查询其所在的GroupID
     * @param appId
     * @param appSecret
     * @param openId 用户的OpenID
     * @return 如：{ "groupid": 102 }
     */
    public static JSONObject getUserGroup(String appId, String appSecret, String openId){
        String url = "https://api.weixin.qq.com/cgi-bin/groups/getid?access_token=" + AccessTokenInfo.accessToken.getAccessToken();
        JSONObject j = new JSONObject();
        try {
        	j.put("openid", openId);
        } catch (JSONException e1) {
            e1.printStackTrace();
        }
       
        String rtn = weixinRequest(url, j.toString(), "POST");
        System.out.println("用户分组："+rtn);
        JSONObject json;
        try {
            json = new JSONObject(JSON.parseObject(rtn));
        } catch (JSONException e) {
            throw new RuntimeException(e.getMessage(),e);
        }
        return json;
    }

8.用户管理

标签功能目前支持公众号为用户打上最多20个标签。

1. 批量为用户打标签

接口调用请求说明

http请求方式：POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/tags/members/batchtagging?access_token=ACCESS_TOKEN

POST数据例子：

{   "openid_list" : [//粉丝列表    
"ocYxcuAEy30bX0NXmGn4ypqx3tI0",    
"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"   ],   
"tagid" : 134 }

返回说明（正常时返回的json包示例）

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

错误码说明

错误码说明
-1系统繁忙
40032每次传入的openid列表个数不能超过50个
45159非法的标签
45059有粉丝身上的标签数已经超过限制，即超过20个
40003传入非法的openid
49003传入的openid不属于此AppID

2. 批量为用户取消标签

接口调用请求说明

http请求方式：POST（请使用https协议） 
https://api.weixin.qq.com/cgi-bin/tags/members/batchuntagging?access_token=ACCESS_TOKEN

POST数据格式：JSON 
POST数据例子：

{   "openid_list" : [//粉丝列表     
"ocYxcuAEy30bX0NXmGn4ypqx3tI0",     
"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"   ],   
"tagid" : 134 }

返回说明（正常时返回的json包示例）

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

错误码说明

错误码说明
-1系统繁忙
40032每次传入的openid列表个数不能超过50个
45159非法的标签
40003传入非法的openid
49003传入的openid不属于此AppID

9.工具类

    private static String weixinRequest(String urlStr, String data, String method){
		try {
			System.setProperty("jsse.enableSNIExtension", "false");
			
//			SSLContext ctx = SSLContext.getInstance("TLS");
//			SSLSocketFactory factory = ctx.getSocketFactory();
			
			URL url = new URL(urlStr);
			HttpsURLConnection http = (HttpsURLConnection) url.openConnection();
			http.setHostnameVerifier(new HostnameVerifier(){
                @Override
                public boolean verify(String arg0, SSLSession arg1) {
                    return true;
                }
            });
//			http.setSSLSocketFactory(factory);
			if(method == null || "".equals(method))method = "GET";
			http.setRequestMethod(method);
			http.setRequestProperty("Content-Type",
					"application/x-www-form-urlencoded");
			http.setDoOutput(true);
			http.setDoInput(true);
			System.setProperty("sun.net.client.defaultConnectTimeout", "30000");// 连接超时30秒
			System.setProperty("sun.net.client.defaultReadTimeout", "30000"); // 读取超时30秒
			http.connect();
			if(data != null && !"".equals(data)){
				OutputStream os = http.getOutputStream();
				os.write(data.getBytes("UTF-8"));// 传入参数
				os.flush();
				os.close();
			}

			InputStream is = http.getInputStream();
			int size = is.available();
			byte[] jsonBytes = new byte[size];
			is.read(jsonBytes);
			String message = new String(jsonBytes, "UTF-8");
			return message;
		} catch (Exception e) {
			throw new RuntimeException(e.getMessage(),e);
		}
	}

全部代码https://download.csdn.net/download/u011752195/10721016

如果缺少工具包请参考https://download.csdn.net/download/u011752195/10721024  包括commons-codec-1.9 commons-httpclient-3.0 commons-logging-1.2 dom4j-2.0.2 fastjson-1.2.49 httpcore-4.4.3

整个下来通过网络资源整理学习，并且完善了一些代码，程序员挺累的

如果觉得不错可以点歌关注吧~

后续将分享更多程序代码~

合作请联系chat 1012638162

有问题可以在下面提出来~

如果本文对您有一丢丢帮助，可以通过下方二维码支持作者哦 后续将分享更多高质量代码~

        Alipay                    WeChat

      

V亮亮
关注
  • 0
    点赞
  • 踩
  • 12
    收藏
    觉得还不错? 一键收藏
  • 13
    评论
专栏目录
微信公众号开发之根据标签进行群发（十三）
易雪寒的博客
01-20 1286
上一篇我们讲解了如何上传我们需要的图文素材，这一篇我们讲解如何群发我们已经上传的素材，今天我们主要讲解根据标签进行群发 根据标签进行群发【订阅号与服务号认证后均可用】 接口调用请求说明 http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN POST数...
【微信公众号】13、SpringBoot整合WxJava获取用户管理（用户列表、基本信息、设置备注、用户迁移）
热门推荐
Asurplus
07-10 3万+
公众号可通过本接口来获取帐号的关注者列表，关注者列表由一串OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的）组成。一次拉取调用最多拉取10000个关注者的OpenID，可以通过多次拉取的方式来满足需求。
JAVA微信公众号对接openId群发图文
senli_ll的博客
05-22 338
需求说明：微信公众号需要对特定的关注用户群发图文消息。根据自己的业务需求来选择群发方式标签或者openid选择对应的接口地址发送内容也根据自己业务需求来拼装参数下面是根据用户openId推送图片内容。以上就是今天要讲的内容，根据自己是发送图文、视频、音频、图片来组装对应的参数就行。
java版微信公众号开发（七）根据OpenID列表群发
weixin_70044963的博客
05-29 314
微信公众号根据OpenID列表群发消息
java实现微信公众号群发文本消息
qq_41936224的博客
12-15 6351
微信开发平台：https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Batch_Sends_and_Originality_Checks.html
Delphi微信公众号开发
PRSoft的博客
07-11 2191
开发微信公众号一般用php，java 等工具开发，很少用delphi开发，这里基于delphiwebmvc 开发的微信公众号部分代码进行开源。 开源地址：https://gitee.com/pearroom/Wechat DelphiWebMVC框架下的微信公众号管理平台 完成公众号文本，图文，声音等消息的处理。 当前封装的功能 property access_token: string ...
微信公众号开发步骤
奔跑的蜗牛AZ的博客
08-09 2966
1，下载内网穿透工具，此处用的是 https://www.ngrok.cc/login.html ，注册，登陆，隧道管理，新建隧道，指定映射到的本地的 IP 以及 端口 2，申请测试服务号，基本均可满足开发需求，申请网址如下： https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index 3，登陆微信公众号，进行相关配置。需要将自己在 第一步 设置的域名配置到公众号的配置中 微信公众号地址：ht
【java springboot调用微信公众平台（公众号）api】
tongliakatong的博客
04-12 714
java springboot调用微信公众平台（公众号）api
微信公众号开发 - 静默授权登录
07-12 4446
基本概念： openid是什么，一个微信号与一个公众号对应一个固定不变的openid。所以一个微信号在一个公众号下的openid是不变的，如果换了一个对应的公众号，那就是另一个openid了。且只有在微信自带浏览器中打开的项目才可获取到。 UnionID是什么，如果开发者拥有多个移动应用...
java版微信公众号开发之：自定义菜单的创建
05-12
微信公众号自定义菜单 使用的时候 替换自己的appid 和appsecret
java微信公众号开发.zip
07-19
微信公众号开发案例，使用的是SpringMVC+MyBatis框架。附带数据库。
java微信公众号开发第一步 公众号接入和access_token管理
09-02
主要为大家介绍了java微信公众号开发，主要内容包括公众号接入和access_token管理，感兴趣的小伙伴们可以参考一下
java 微信公众号开发入门 DEMO 可直接跑起来的
09-21
java 微信公众号开发入门 DEMO 可直接跑起来的 大家可以直接下载，然后练习一下。java 微信公众号开发入门 DEMO 可直接跑起来的 大家可以直接下载，然后练习一下。
Android 更换applicationId 后 微信没有回调
七夜的博客
07-24 307
android 微信没有回调
pi_heif-0.17.0-cp310-cp310-manylinux_2_17_aarch64.whl
07-27
pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。pip install 直接安装，无需再下载，直接用。
Numper基础（一）
07-27
Numper基础（一）
C语言写的潮流计算大作业代码.zip
最新发布
07-27
c写的潮流计算大作业代码.zipc写的潮流计算大作业代码.zipc写的潮流计算大作业代码.zip
评论 13
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值