用户标签接口

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 数据包
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 数据包