net.jlxxw.wechat.function.tag

类 TagManager

java.lang.Object

net.jlxxw.wechat.function.tag.TagManager

@DependsOn(value="weChatTokenManager")
 @Component
public class TagManager
extends Object

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

作者:

chunyang.leng

另请参阅:

文档地址

构造器概要

构造器

构造器和说明
TagManager()

方法概要

限定符和类型	方法和说明
WeChatResponse	batchTagging(@NotEmpty(message="\u7528\u6237id\u5217\u8868\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=50,message="\u6bcf\u6b21\u4f20\u5165\u7684 openid \u5217\u8868\u4e2a\u6570\u4e0d\u80fd\u8d85\u8fc750\u4e2a") List<String> openIdList, @NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a") Integer tagId) 用户批量打标签 标签功能目前支持公众号为用户打上最多20个标签。
WeChatResponse	batchUnTagging(@NotEmpty(message="\u7528\u6237id\u5217\u8868\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=50,message="\u6bcf\u6b21\u4f20\u5165\u7684 openid \u5217\u8868\u4e2a\u6570\u4e0d\u80fd\u8d85\u8fc750\u4e2a") List<String> openIdList, @NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a") Integer tagId) 批量取消用户标签 标签功能目前支持公众号为用户打上最多20个标签。
TagResponse	createTag(@NotBlank(message="\u6807\u7b7e\u540d\u5b57\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=30,message="\u6700\u5927\u957f\u5ea6\u4e0d\u80fd\u8d85\u8fc730\u4e2a\u5b57\u7b26") String tagValue) 创建公众号标签 一个公众号，最多可以创建100个标签。
WeChatResponse	delete(@NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a") Integer id) 删除标签
List<Tag>	getTag() 获取公众号已创建的标签
TagUserResponse	getTagUser(@NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a") Integer tagId, String nextOpenId) 获取标签下粉丝列表
List<Integer>	getUserTags(String openId) 获取用户身上的标签，最多标签数量 20
WeChatResponse	updateTag(@NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a") Integer id, @NotBlank(message="\u6807\u7b7e\u540d\u5b57\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=30,message="\u6700\u5927\u957f\u5ea6\u4e0d\u80fd\u8d85\u8fc730\u4e2a\u5b57\u7b26") String tagValue) 更新标签

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

TagManager

public TagManager()

方法详细资料

createTag

public TagResponse createTag(@NotBlank(message="\u6807\u7b7e\u540d\u5b57\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=30,message="\u6700\u5927\u957f\u5ea6\u4e0d\u80fd\u8d85\u8fc730\u4e2a\u5b57\u7b26")
                             @NotBlank(message="\u6807\u7b7e\u540d\u5b57\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=30,message="\u6700\u5927\u957f\u5ea6\u4e0d\u80fd\u8d85\u8fc730\u4e2a\u5b57\u7b26") String tagValue)
                      throws WeChatException,
                             ParamCheckException

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

参数:

tagValue - 要创建的标签

抛出:

WeChatException - 微信验证异常

ParamCheckException - 参数检查不通过

getTag

public List<Tag> getTag()
                 throws WeChatException

获取公众号已创建的标签

抛出:

WeChatException - 微信服务端验证异常

updateTag

public WeChatResponse updateTag(@NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a")
                                @NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a") Integer id,
                                @NotBlank(message="\u6807\u7b7e\u540d\u5b57\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=30,message="\u6700\u5927\u957f\u5ea6\u4e0d\u80fd\u8d85\u8fc730\u4e2a\u5b57\u7b26")
                                @NotBlank(message="\u6807\u7b7e\u540d\u5b57\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=30,message="\u6700\u5927\u957f\u5ea6\u4e0d\u80fd\u8d85\u8fc730\u4e2a\u5b57\u7b26") String tagValue)
                         throws WeChatException,
                                ParamCheckException

更新标签

参数:

id - 标签id

tagValue - 新的标签值

返回:

抛出:

WeChatException - 微信验证异常

ParamCheckException - 参数检查不通过

delete

public WeChatResponse delete(@NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a")
                             @NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a") Integer id)
                      throws WeChatException,
                             ParamCheckException

删除标签

参数:

id - 标签id

返回:

抛出:

WeChatException - 微信验证异常

ParamCheckException - 参数检查不通过

getTagUser

public TagUserResponse getTagUser(@NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a")
                                  @NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a") Integer tagId,
                                  String nextOpenId)
                           throws WeChatException,
                                  ParamCheckException

获取标签下粉丝列表

参数:

tagId - 标签id

nextOpenId - 第一个拉取的OPENID，不填默认从头开始拉取

返回:

抛出:

WeChatException - 微信验证异常

ParamCheckException - 参数检查不通过

batchTagging

public WeChatResponse batchTagging(@NotEmpty(message="\u7528\u6237id\u5217\u8868\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=50,message="\u6bcf\u6b21\u4f20\u5165\u7684 openid \u5217\u8868\u4e2a\u6570\u4e0d\u80fd\u8d85\u8fc750\u4e2a")
                                   @NotEmpty(message="\u7528\u6237id\u5217\u8868\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=50,message="\u6bcf\u6b21\u4f20\u5165\u7684 openid \u5217\u8868\u4e2a\u6570\u4e0d\u80fd\u8d85\u8fc750\u4e2a") List<String> openIdList,
                                   @NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a")
                                   @NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a") Integer tagId)
                            throws WeChatException,
                                   ParamCheckException

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

参数:

openIdList - 用户列表，每次传入的 openid 列表个数不能超过50个

tagId - 标签id

返回:

抛出:

WeChatException - 微信验证异常

ParamCheckException - 参数检查不通过

batchUnTagging

public WeChatResponse batchUnTagging(@NotEmpty(message="\u7528\u6237id\u5217\u8868\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=50,message="\u6bcf\u6b21\u4f20\u5165\u7684 openid \u5217\u8868\u4e2a\u6570\u4e0d\u80fd\u8d85\u8fc750\u4e2a")
                                     @NotEmpty(message="\u7528\u6237id\u5217\u8868\u4e0d\u80fd\u4e3a\u7a7a") @Size(max=50,message="\u6bcf\u6b21\u4f20\u5165\u7684 openid \u5217\u8868\u4e2a\u6570\u4e0d\u80fd\u8d85\u8fc750\u4e2a") List<String> openIdList,
                                     @NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a")
                                     @NotNull(message="\u6807\u7b7eid\u4e0d\u80fd\u4e3a\u7a7a") Integer tagId)
                              throws WeChatException,
                                     ParamCheckException

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

参数:

openIdList - 用户列表，每次传入的 openid 列表个数不能超过50个

tagId - 标签id

返回:

抛出:

WeChatException - 微信验证异常

ParamCheckException - 参数检查不通过

getUserTags

public List<Integer> getUserTags(String openId)
                          throws WeChatException,
                                 ParamCheckException

获取用户身上的标签，最多标签数量 20

参数:

openId - 用户openId

返回:

标签列表

抛出:

WeChatException - 微信验证异常

ParamCheckException - 参数检查不通过