用户标签接口#
- class wechatpy.client.api.WeChatTag(client=None)[源代码]#
- batch_black_list(openid_list)[源代码]#
批量拉黑用户
详情请参考 https://developers.weixin.qq.com/doc/offiaccount/User_Management/Manage_blacklist.html
- 参数
openid_list (list) – 批量拉黑用户的 OpenID list, 最多20个
- batch_unblack_list(openid_list)[源代码]#
批量取消拉黑
详情请参考 https://developers.weixin.qq.com/doc/offiaccount/User_Management/Manage_blacklist.html
- 参数
openid_list (list) – 批量取消拉黑的 OpenID list, 最多20个
- create(name)[源代码]#
创建标签
详情请参考 https://developers.weixin.qq.com/doc/offiaccount/User_Management/User_Tag_Management.html
- 参数
name – 标签名(30个字符以内)
- 返回
返回的 JSON 数据包
- delete(tag_id)[源代码]#
删除标签
详情请参考 https://developers.weixin.qq.com/doc/offiaccount/User_Management/User_Tag_Management.html
- 参数
tag_id – 标签 ID
- 返回
返回的 JSON 数据包
- get()[源代码]#
获取公众号已创建的标签
详情请参考 https://developers.weixin.qq.com/doc/offiaccount/User_Management/User_Tag_Management.html
- 返回
所有标签列表
- get_black_list(begin_openid=None)[源代码]#
获取公众号的黑名单列表
详情请参考 https://developers.weixin.qq.com/doc/offiaccount/User_Management/Manage_blacklist.html
- 参数
begin_openid – 起始的 OpenID,传空则默认从头开始拉取
- 返回
返回的 JSON 数据包
- 返回类型
dict
- get_tag_users(tag_id, first_user_id=None)[源代码]#
获取标签下粉丝列表
详情请参考 https://developers.weixin.qq.com/doc/offiaccount/User_Management/User_Tag_Management.html
- 参数
tag_id – 标签 ID
first_user_id – 可选。第一个拉取的 OPENID,不填默认从头开始拉取
- 返回
返回的 JSON 数据包
- get_user_tag(user_id)[源代码]#
获取用户身上的标签列表
详情请参考 https://developers.weixin.qq.com/doc/offiaccount/User_Management/User_Tag_Management.html
- 参数
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)[源代码]#
批量为用户打标签
详情请参考 https://developers.weixin.qq.com/doc/offiaccount/User_Management/User_Tag_Management.html
- 参数
tag_id – 标签 ID
user_id – 用户 ID, 可以是单个或者列表
- 返回
返回的 JSON 数据包
- untag_user(tag_id, user_id)[源代码]#
批量为用户取消标签
详情请参考 https://developers.weixin.qq.com/doc/offiaccount/User_Management/User_Tag_Management.html
- 参数
tag_id – 标签 ID
user_id – 用户 ID, 可以是单个或者列表
- 返回
返回的 JSON 数据包
- update(tag_id, name)[源代码]#
编辑标签
详情请参考 https://developers.weixin.qq.com/doc/offiaccount/User_Management/User_Tag_Management.html
- 参数
tag_id – 标签id,由微信分配
name – 标签名字(30个字符以内)
- 返回
返回的 JSON 数据包