UserTagComponent (wechat middleware 0.6-RELEASE API)

java.lang.Object
- cn.zkdcloud.core.UserTagComponent

所有已实现的接口:

Component
```
public class UserTagComponent
extends Object
implements Component
```
用户标签管理组件(一个公账号最多添加100个标签)

版本:

2017/9/2

作者:

zk

字段概要

字段
限定符和类型	字段和说明
`static String`	`BATCH_TAG_URL` 批量为用户打标签(POST,标签功能目前支持公众号为用户打上最多20个标签。)
`static String`	`BATCH_UNTAG_URL` 批量为用户取消标签(POST)
`static String`	`CREATE_TAG_URL` 创建标签(POST)
`static String`	`DELETE_TAG_URL` 删除标签(POST)
`static String`	`GET_TAG_URL` 获取公众号已创建的标签列表(GET)
`static String`	`GET_TAG_USERS` 获取某标签下粉丝列表
`static String`	`GET_TAGS_BY_USER` 获取用户身上的标签列表(POST)
`static String`	`UPDATE_TAG_URL` 编辑标签(POST)
`static UserTagComponent`	`userTagComponent`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`boolean`	`batchTags(List<String> openid_list, Integer tagid)` 批量为用户打标签
`boolean`	`batchUnTags(List<String> openid_list, Integer tagid)` 批量为用户取消标签
`String`	`createTag(String tagName)` 添加标签
`boolean`	`deleteTag(Integer id)` 删除标签请注意，当某个标签下的粉丝超过10w时，后台不可直接删除标签。
`static UserTagComponent`	`getInstance()` 获取用户标签管理组件实例
`com.alibaba.fastjson.JSONArray`	`getTags()` 获取标签列表
`List<Integer>`	`getTagsByUser(String open_id)` 获取某用户身上的标签
`List<String>`	`getUserByTagId(Integer tagid)` 根据标签id获取用户列表
`List<String>`	`getUserByTagId(Integer tagid, String next_openid)` 根据标签id获取用户列表
`void`	`init()`
`boolean`	`updateTag(Integer id, String tagName)` 修改标签

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - userTagComponent
```
public static UserTagComponent userTagComponent
```
  - CREATE_TAG_URL
```
public static String CREATE_TAG_URL
```
    创建标签(POST)
  - GET_TAG_URL
```
public static String GET_TAG_URL
```
    获取公众号已创建的标签列表(GET)
  - UPDATE_TAG_URL
```
public static String UPDATE_TAG_URL
```
    编辑标签(POST)
  - DELETE_TAG_URL
```
public static String DELETE_TAG_URL
```
    删除标签(POST)
  - GET_TAG_USERS
```
public static String GET_TAG_USERS
```
    获取某标签下粉丝列表
  - BATCH_TAG_URL
```
public static String BATCH_TAG_URL
```
    批量为用户打标签(POST,标签功能目前支持公众号为用户打上最多20个标签。)
  - BATCH_UNTAG_URL
```
public static String BATCH_UNTAG_URL
```
    批量为用户取消标签(POST)
  - GET_TAGS_BY_USER
```
public static String GET_TAGS_BY_USER
```
    获取用户身上的标签列表(POST)
- 方法详细资料
  - init
```
public void init()
```
    指定者:
    
    init 在接口中 Component
  - createTag
```
public String createTag(String tagName)
                 throws WeChatException
```
    添加标签
    
    参数:
    
    tagName - tagName 标签名
    
    返回:
    
    ret; { "tag":{ "id":134,//标签id "name":"广东" } }
    
    抛出:
    
    WeChatException
  - getTags
```
public com.alibaba.fastjson.JSONArray getTags()
```
    获取标签列表
    
    返回:
    
    jsonArray [ { "id":1, "name":"每天一罐可乐星人", "count":0 //此标签下粉丝数 }, { "id":2, "name":"星标组", "count":0 }, { "id":127, "name":"广东", "count":5 } ]
  - updateTag
```
public boolean updateTag(Integer id,
                         String tagName)
```
    修改标签
    
    参数:
    
    id - tag's id
    
    tagName - 标签名
    
    返回:
    
    is or not success
  - deleteTag
```
public boolean deleteTag(Integer id)
```
    删除标签
    请注意，当某个标签下的粉丝超过10w时，后台不可直接删除标签。此时，开发者可以对该标签下的openid列表，先进行取消标签的操作，直到粉丝数不超过10w后，才可直接删除该标签。
    
    参数:
    
    id - 标签id
    
    返回:
    
    is or not delete
  - getUserByTagId
```
public List<String> getUserByTagId(Integer tagid)
```
    根据标签id获取用户列表
    
    参数:
    
    tagid - tagid
    
    返回:
    
    list
  - getUserByTagId
```
public List<String> getUserByTagId(Integer tagid,
                                   String next_openid)
```
    根据标签id获取用户列表
    
    参数:
    
    tagid - tagid
    
    next_openid - 第一个拉取的OPENID，不填默认从头开始拉取
    
    返回:
    
    list
  - batchTags
```
public boolean batchTags(List<String> openid_list,
                         Integer tagid)
```
    批量为用户打标签
    
    参数:
    
    openid_list - 用户open_id列表
    
    tagid - 标签id
    
    返回:
    
    is or not success
  - batchUnTags
```
public boolean batchUnTags(List<String> openid_list,
                           Integer tagid)
```
    批量为用户取消标签
    
    参数:
    
    openid_list - 用户open_id 列表
    
    tagid - 标签id
    
    返回:
    
    is or not success
  - getTagsByUser
```
public List<Integer> getTagsByUser(String open_id)
```
    获取某用户身上的标签
    
    参数:
    
    open_id - user's openid
    
    返回:
    
    List
  - getInstance
```
public static UserTagComponent getInstance()
```
    获取用户标签管理组件实例
    
    返回:
    
    userTagComponentBean

类 UserTagComponent

字段概要

方法概要

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

字段详细资料

userTagComponent

CREATE_TAG_URL

GET_TAG_URL

UPDATE_TAG_URL

DELETE_TAG_URL

GET_TAG_USERS

BATCH_TAG_URL

BATCH_UNTAG_URL

GET_TAGS_BY_USER

方法详细资料

init

createTag

getTags

updateTag

deleteTag

getUserByTagId

getUserByTagId

batchTags

batchUnTags

getTagsByUser

getInstance