用户标签

用户标签的使用就非常简单了，基本的增删改查。

获取实例

  1. <?php
  2. use EasyWeChat\Foundation\Application;
  4. // ...
  6. $app = new Application($options);
  8. $tag = $app->user_tag; // $user['user_tag']

API

获取所有标签

  1. $tag->lists();

example:

  1. $tags = $tag->lists();
  3. // {
  4. //     "tags": [
  5. //         {
  6. //             "id": 0,
  7. //             "name": "标签1",
  8. //             "count": 72596
  9. //         },
  10. //         {
  11. //             "id": 1,
  12. //             "name": "标签2",
  13. //             "count": 36
  14. //         },
  15. //         ...
  16. //     ]
  17. // }
  19. var_dump($tags->tags[0]['name']) // “标签1”

创建标签

  1. $tag->create($name);

example:

  1. $tag->create('测试标签');

修改标签信息

  1. $tag->update($tagId, $name);

example:

  1. $tag->update(12, "新的名称");

删除标签

  1. $tag->delete($tagId);

example:

  1. $tag->delete($tagId);

获取指定 openid 用户身上的标签

  1. $userTags = $tag->userTags($openId);
  2. //
  3. // {
  4. //     "tagid_list":["标签1","标签2"]
  5. // }

获取标签下粉丝列表

  1. $tag->usersOfTag($tagId, $nextOpenId = '');
  2. // $nextOpenId：第一个拉取的OPENID，不填默认从头开始拉取
  4. // {
  5. //   "count":2,//这次获取的粉丝数量
  6. //   "data":{//粉丝列表
  7. //      "openid":[
  8. //          "ocYxcuAEy30bX0NXmGn4ypqx3tI0",
  9. //          "ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"
  10. //      ]
  11. //   },
  12. //   "next_openid":"ocYxcuBt0mRugKZ7tGAHPnUaOW7Y"//拉取列表最后一个用户的openid
  13. // }

批量为用户打标签

  1. $openIds = [$openId1, $openId2, ...];
  2. $tag->batchTagUsers($openIds, $tagId);

批量为用户取消标签

  1. $openIds = [$openId1, $openId2, ...];
  2. $tag->batchUntagUsers($openIds, $tagId);

关于用户管理请参考微信官方文档：http://mp.weixin.qq.com/wiki/ 用户管理 章节。