user

Documentation

Overview

Package user blacklist 公众号用户黑名单管理 参考文档：https://developers.weixin.qq.com/doc/offiaccount/User_Management/Manage_blacklist.html

Package user migrate 用于微信公众号账号迁移，获取openID变化 参考文档：https://kf.qq.com/faq/1901177NrqMr190117nqYJze.html

Index

• type ChangeOpenIDResult
• type ChangeOpenIDResultList
• type Info
• type OpenidList
• type TagInfo
• type TagOpenIDList
• type User
  • func NewUser(context *context.Context) *User
  • func (user *User) BatchBlackList(openidList ...string) (err error)
  • func (user *User) BatchTag(openIDList []string, tagID int32) (err error)
  • func (user *User) BatchUnBlackList(openidList ...string) (err error)
  • func (user *User) BatchUntag(openIDList []string, tagID int32) (err error)
  • func (user *User) CreateTag(tagName string) (tagInfo *TagInfo, err error)
  • func (user *User) DeleteTag(tagID int32) (err error)
  • func (user *User) GetAllBlackList() (openIDList []string, err error)
  • func (user *User) GetBlackList(beginOpenid ...string) (userlist *OpenidList, err error)
  • func (user *User) GetTag() (tags []*TagInfo, err error)
  • func (user *User) GetUserInfo(openID string) (userInfo *Info, err error)
  • func (user *User) ListAllChangeOpenIDs(fromAppID string, openIDs ...string) (list []ChangeOpenIDResult, err error)
  • func (user *User) ListAllUserOpenIDs() ([]string, error)
  • func (user *User) ListChangeOpenIDs(fromAppID string, openIDs ...string) (list *ChangeOpenIDResultList, err error)
  • func (user *User) ListUserOpenIDs(nextOpenid ...string) (*OpenidList, error)
  • func (user *User) OpenIDListByTag(tagID int32, nextOpenID ...string) (userList *TagOpenIDList, err error)
  • func (user *User) UpdateRemark(openID, remark string) (err error)
  • func (user *User) UpdateTag(tagID int32, tagName string) (err error)
  • func (user *User) UserTidList(openID string) (tagIDList []int32, err error)

Types

type ChangeOpenIDResult

type ChangeOpenIDResult struct {
	OriOpenID string `json:"ori_openid"`
	NewOpenID string `json:"new_openid"`
	ErrMsg    string `json:"err_msg,omitempty"`
}

ChangeOpenIDResult OpenID迁移变化

type ChangeOpenIDResultList

type ChangeOpenIDResultList struct {
	util.CommonError
	List []ChangeOpenIDResult `json:"result_list"`
}

ChangeOpenIDResultList OpenID迁移变化列表

type Info

type Info struct {
	util.CommonError

	Subscribe      int32   `json:"subscribe"`
	OpenID         string  `json:"openid"`
	Nickname       string  `json:"nickname"`
	Sex            int32   `json:"sex"`
	City           string  `json:"city"`
	Country        string  `json:"country"`
	Province       string  `json:"province"`
	Language       string  `json:"language"`
	Headimgurl     string  `json:"headimgurl"`
	SubscribeTime  int32   `json:"subscribe_time"`
	UnionID        string  `json:"unionid"`
	Remark         string  `json:"remark"`
	GroupID        int32   `json:"groupid"`
	TagIDList      []int32 `json:"tagid_list"`
	SubscribeScene string  `json:"subscribe_scene"`
	QrScene        int     `json:"qr_scene"`
	QrSceneStr     string  `json:"qr_scene_str"`
}

Info 用户基本信息

type OpenidList

type OpenidList struct {
	util.CommonError

	Total int `json:"total"`
	Count int `json:"count"`
	Data  struct {
		OpenIDs []string `json:"openid"`
	} `json:"data"`
	NextOpenID string `json:"next_openid"`
}

OpenidList 用户列表

type TagInfo

type TagInfo struct {
	ID    int32  `json:"id"`
	Name  string `json:"name"`
	Count int64  `json:"count"`
}

TagInfo 标签信息

type TagOpenIDList

type TagOpenIDList struct {
	Count int `json:"count"`
	Data  struct {
		OpenIDs []string `json:"openid"`
	} `json:"data"`
	NextOpenID string `json:"next_openid"`
}

TagOpenIDList 标签用户列表

type User

type User struct {
	*context.Context
}

User 用户管理

func NewUser

func NewUser(context *context.Context) *User

NewUser 实例化

func (*User) BatchBlackList

func (user *User) BatchBlackList(openidList ...string) (err error)

BatchBlackList 拉黑用户 参数 openidList：需要拉入黑名单的用户的openid，每次拉黑最多允许20个

func (*User) BatchTag

func (user *User) BatchTag(openIDList []string, tagID int32) (err error)

BatchTag 批量为用户打标签

func (*User) BatchUnBlackList

func (user *User) BatchUnBlackList(openidList ...string) (err error)

BatchUnBlackList 取消拉黑用户 参数 openidList：需要取消拉入黑名单的用户的openid，每次拉黑最多允许20个

func (*User) BatchUntag

func (user *User) BatchUntag(openIDList []string, tagID int32) (err error)

BatchUntag 批量为用户取消标签

func (*User) CreateTag

func (user *User) CreateTag(tagName string) (tagInfo *TagInfo, err error)

CreateTag 创建标签

func (*User) DeleteTag

func (user *User) DeleteTag(tagID int32) (err error)

DeleteTag 删除标签

func (*User) GetAllBlackList

func (user *User) GetAllBlackList() (openIDList []string, err error)

GetAllBlackList 获取公众号的所有黑名单列表

func (*User) GetBlackList

func (user *User) GetBlackList(beginOpenid ...string) (userlist *OpenidList, err error)

GetBlackList 获取公众号的黑名单列表 该接口每次调用最多可拉取 1000 个OpenID，当列表数较多时，可以通过多次拉取的方式来满足需求。 参数 beginOpenid：当 begin_openid 为空时，默认从开头拉取。

func (*User) GetTag

func (user *User) GetTag() (tags []*TagInfo, err error)

GetTag 获取公众号已创建的标签

func (*User) GetUserInfo

func (user *User) GetUserInfo(openID string) (userInfo *Info, err error)

GetUserInfo 获取用户基本信息

func (*User) ListAllChangeOpenIDs

func (user *User) ListAllChangeOpenIDs(fromAppID string, openIDs ...string) (list []ChangeOpenIDResult, err error)

ListAllChangeOpenIDs 返回所有用户OpenID列表 fromAppID 为老账号AppID openIDs 为老账号的openID AccessToken 为新账号的AccessToken

func (*User) ListAllUserOpenIDs

func (user *User) ListAllUserOpenIDs() ([]string, error)

ListAllUserOpenIDs 返回所有用户OpenID列表

func (*User) ListChangeOpenIDs

func (user *User) ListChangeOpenIDs(fromAppID string, openIDs ...string) (list *ChangeOpenIDResultList, err error)

ListChangeOpenIDs 返回指定OpenID变化列表 fromAppID 为老账号AppID openIDs 为老账号的openID，openIDs限100个以内 AccessToken 为新账号的AccessToken

func (*User) ListUserOpenIDs

func (user *User) ListUserOpenIDs(nextOpenid ...string) (*OpenidList, error)

ListUserOpenIDs 返回用户列表

func (*User) OpenIDListByTag

func (user *User) OpenIDListByTag(tagID int32, nextOpenID ...string) (userList *TagOpenIDList, err error)

OpenIDListByTag 获取标签下粉丝列表

func (*User) UpdateRemark

func (user *User) UpdateRemark(openID, remark string) (err error)

UpdateRemark 设置用户备注名

func (*User) UpdateTag

func (user *User) UpdateTag(tagID int32, tagName string) (err error)

UpdateTag 编辑标签

func (*User) UserTidList

func (user *User) UserTidList(openID string) (tagIDList []int32, err error)

UserTidList 获取用户身上的标签列表