用户标签接口#

class wechatpy.client.api.WeChatTag(client=None)[源代码]#
batch_black_list(openid_list)[源代码]#

批量拉黑用户 详情请参考 https://mp.weixin.qq.com/wiki?id=mp1471422259_pJMWA

参数

openid_list (list) – 批量拉黑用户的 OpenID list, 最多20个

batch_unblack_list(openid_list)[源代码]#

批量取消拉黑 详情请参考 https://mp.weixin.qq.com/wiki?id=mp1471422259_pJMWA

参数

openid_list (list) – 批量取消拉黑的 OpenID list, 最多20个

create(name)[源代码]#

创建标签

参数

name – 标签名(30个字符以内)

返回

返回的 JSON 数据包

delete(tag_id)[源代码]#

删除标签

参数

tag_id – 标签 ID

返回

返回的 JSON 数据包

get()[源代码]#

获取公众号已创建的标签

返回

所有标签列表

get_black_list(begin_openid=None)[源代码]#

获取公众号的黑名单列表 详情请参考 https://mp.weixin.qq.com/wiki?id=mp1471422259_pJMWA

参数

begin_openid – 起始的 OpenID,传空则默认从头开始拉取

返回

返回的 JSON 数据包

返回类型

dict

get_tag_users(tag_id, first_user_id=None)[源代码]#

获取标签下粉丝列表

参数
  • tag_id – 标签 ID

  • first_user_id – 可选。第一个拉取的 OPENID,不填默认从头开始拉取

返回

返回的 JSON 数据包

get_user_tag(user_id)[源代码]#

获取用户身上的标签列表

参数

user_id – 用户 ID, 可以是单个或者列表

返回

返回的 JSON 数据包

iter_tag_users(tag_id, first_user_id=None)[源代码]#

获取标签下粉丝openid列表

返回

返回一个迭代器,可以用for进行循环,得到openid

使用示例:

from wechatpy import WeChatClient

client = WeChatClient('appid', 'secret')
for openid in client.tag.iter_tag_users(0):
    print(openid)
tag_user(tag_id, user_id)[源代码]#

批量为用户打标签

参数
  • tag_id – 标签 ID

  • user_id – 用户 ID, 可以是单个或者列表

返回

返回的 JSON 数据包

untag_user(tag_id, user_id)[源代码]#

批量为用户取消标签

参数
  • tag_id – 标签 ID

  • user_id – 用户 ID, 可以是单个或者列表

返回

返回的 JSON 数据包

update(tag_id, name)[源代码]#

编辑标签

参数
  • tag_id – 标签id,由微信分配

  • name – 标签名字(30个字符以内)

返回

返回的 JSON 数据包