me.chanjar.weixin.mp.api

接口 WxMpGuideBuyerService

所有已知实现类:

WxMpGuideBuyerServiceImpl

public interface WxMpGuideBuyerService

The interface Wx mp guide buyer service.

作者:

广州跨界-宋心成 created on 2021/5/13/013

方法概要

限定符和类型	方法和说明
List<WxMpGuideBuyerResp>	addGuideBuyerRelation(String account, String openid, List<WxMpAddGuideBuyerInfo> infos) 为顾问分配客户(批量) 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/addguidebuyerrelation?
void	addGuideBuyerRelation(String account, String openid, String userOpenid, String nickname) 为顾问分配客户(单个)
List<WxMpGuideBuyerResp>	delGuideBuyerRelation(String account, String openid, List<String> buyerOpenIds) 为顾问移除客户(批量) 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/delguidebuyerrelation?
void	delGuideBuyerRelation(String account, String openid, String userOpenid) 为顾问移除客户(单个)
WxMpGuideBuyerInfo	getGuideBuyerRelation(String account, String openid, String userOpenid) 查询指定顾问和客户的关系 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/getguidebuyerrelation?
WxMpGuideBuyerRelation	getGuideBuyerRelationByBuyer(String openid) 查询客户所属顾问 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/getguidebuyerrelationbybuyer?
WxMpGuideBuyerInfoList	getGuideBuyerRelationList(String account, String openid, int page, int num) 获取顾问的客户列表 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/getguidebuyerrelationlist?
List<WxMpGuideBuyerResp>	rebindGuideAcctForBuyer(String oldAccount, String oldOpenid, String account, String openid, List<String> buyerOpenIds) 为客户更换顾问(批量) 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/rebindguideacctforbuyer?
void	rebindGuideAcctForBuyer(String oldAccount, String oldOpenid, String account, String openid, String userOpenid) 为客户更换顾问(单个)
void	updateGuideBuyerRelation(String account, String openid, String userOpenid, String nickname) 修改客户昵称 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/updateguidebuyerrelation?

方法详细资料

addGuideBuyerRelation

List<WxMpGuideBuyerResp> addGuideBuyerRelation(String account,
                                               String openid,
                                               List<WxMpAddGuideBuyerInfo> infos)
                                        throws WxErrorException

为顾问分配客户(批量)

 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/addguidebuyerrelation?access_token=ACCESS_TOKEN
 文档地址：https://developers.weixin.qq.com/doc/offiaccount/Shopping_Guide/buyer-account/shopping-guide.addGuideBuyerRelation.html
 

参数:

account - 顾问微信号（guide_account和guide_openid二选一，若同时请求，默认为guide_account）

openid - 顾问openid或者unionid（guide_account和guide_openid二选一）

infos - 客户列表

返回:

客户列表添加结果 list

抛出:

WxErrorException - .

addGuideBuyerRelation

void addGuideBuyerRelation(String account,
                           String openid,
                           String userOpenid,
                           String nickname)
                    throws WxErrorException

为顾问分配客户(单个)

参数:

account - 顾问微信号（guide_account和guide_openid二选一，若同时请求，默认为guide_account）

openid - 顾问openid或者unionid（guide_account和guide_openid二选一）

userOpenid - 用户openid

nickname - 用户昵称

抛出:

WxErrorException - .

delGuideBuyerRelation

List<WxMpGuideBuyerResp> delGuideBuyerRelation(String account,
                                               String openid,
                                               List<String> buyerOpenIds)
                                        throws WxErrorException

为顾问移除客户(批量)

 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/delguidebuyerrelation?access_token=ACCESS_TOKEN
 文档地址：https://developers.weixin.qq.com/doc/offiaccount/Shopping_Guide/buyer-account/shopping-guide.delGuideBuyerRelation.html
 

参数:

account - 顾问微信号（guide_account和guide_openid二选一，若同时请求，默认为guide_account）

openid - 顾问openid或者unionid（guide_account和guide_openid二选一）

buyerOpenIds - 客户openid列表，不超过200

返回:

客户列表移除结果 list

抛出:

WxErrorException - the wx error exception

delGuideBuyerRelation

void delGuideBuyerRelation(String account,
                           String openid,
                           String userOpenid)
                    throws WxErrorException

为顾问移除客户(单个)

参数:

account - 顾问微信号（guide_account和guide_openid二选一，若同时请求，默认为guide_account）

openid - 顾问openid或者unionid（guide_account和guide_openid二选一）

userOpenid - 用户openid

抛出:

WxErrorException - .

getGuideBuyerRelationList

WxMpGuideBuyerInfoList getGuideBuyerRelationList(String account,
                                                 String openid,
                                                 int page,
                                                 int num)
                                          throws WxErrorException

获取顾问的客户列表

 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/getguidebuyerrelationlist?access_token=ACCESS_TOKEN
 文档地址：https://developers.weixin.qq.com/doc/offiaccount/Shopping_Guide/buyer-account/shopping-guide.getGuideBuyerRelationList.html
 

参数:

account - 顾问微信号（guide_account和guide_openid二选一，若同时请求，默认为guide_account）

openid - 顾问openid或者unionid（guide_account和guide_openid二选一）

page - 分页页数，从0开始，用于组内顾问分页获取

num - 每页数量

返回:

顾问的客户列表 guide buyer relation list

抛出:

WxErrorException - .

rebindGuideAcctForBuyer

List<WxMpGuideBuyerResp> rebindGuideAcctForBuyer(String oldAccount,
                                                 String oldOpenid,
                                                 String account,
                                                 String openid,
                                                 List<String> buyerOpenIds)
                                          throws WxErrorException

为客户更换顾问(批量)

 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/rebindguideacctforbuyer?access_token=ACCESS_TOKEN
 文档地址：https://developers.weixin.qq.com/doc/offiaccount/Shopping_Guide/buyer-account/shopping-guide.rebindGuideAcctForBuyer.html
 

参数:

oldAccount - 原顾问微信号（old_guide_account和new_guide_account配套使用）

oldOpenid - 原顾问openid或者unionid（old_guide_openid和new_guide_openid配套使用）

account - 新顾问微信号（new_guide_account和new_guide_openid二选一）

openid - 新顾问openid或者unionid（new_guide_account和new_guide_openid二选一）

buyerOpenIds - 客户列表，不超过200

返回:

客户列表换绑结果 list

抛出:

WxErrorException - .

rebindGuideAcctForBuyer

void rebindGuideAcctForBuyer(String oldAccount,
                             String oldOpenid,
                             String account,
                             String openid,
                             String userOpenid)
                      throws WxErrorException

为客户更换顾问(单个)

参数:

oldAccount - 原顾问微信号（old_guide_account和new_guide_account配套使用）

oldOpenid - 原顾问openid或者unionid（old_guide_openid和new_guide_openid配套使用）

account - 新顾问微信号（new_guide_account和new_guide_openid二选一）

openid - 新顾问openid或者unionid（new_guide_account和new_guide_openid二选一）

userOpenid - 用户openid

抛出:

WxErrorException - 。

updateGuideBuyerRelation

void updateGuideBuyerRelation(String account,
                              String openid,
                              String userOpenid,
                              String nickname)
                       throws WxErrorException

修改客户昵称

 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/updateguidebuyerrelation?access_token=ACCESS_TOKEN
 文档地址：https://developers.weixin.qq.com/doc/offiaccount/Shopping_Guide/buyer-account/shopping-guide.updateGuideBuyerRelation.html
 

参数:

account - 顾问微信号（guide_account和guide_openid二选一，若同时请求，默认为guide_account）

openid - 顾问openid或者unionid（guide_account和guide_openid二选一）

userOpenid - 客户openid

nickname - 客户昵称

抛出:

WxErrorException - .

getGuideBuyerRelationByBuyer

WxMpGuideBuyerRelation getGuideBuyerRelationByBuyer(String openid)
                                             throws WxErrorException

查询客户所属顾问

 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/getguidebuyerrelationbybuyer?access_token=ACCESS_TOKEN
 文档地址：https://developers.weixin.qq.com/doc/offiaccount/Shopping_Guide/buyer-account/shopping-guide.getGuideBuyerRelationByBuyer.html
 

参数:

openid - 客户openid

返回:

客户顾问关系信息 guide buyer relation by buyer

抛出:

WxErrorException - .

getGuideBuyerRelation

WxMpGuideBuyerInfo getGuideBuyerRelation(String account,
                                         String openid,
                                         String userOpenid)
                                  throws WxErrorException

查询指定顾问和客户的关系

 请求地址： POST https://api.weixin.qq.com/cgi-bin/guide/getguidebuyerrelation?access_token=ACCESS_TOKEN
 文档地址：https://developers.weixin.qq.com/doc/offiaccount/Shopping_Guide/buyer-account/shopping-guide.getGuideBuyerRelation.html
 

参数:

account - 顾问微信号（guide_account和guide_openid二选一，若同时请求，默认为guide_account）

openid - 顾问openid或者unionid（guide_account和guide_openid二选一）

userOpenid - 客户openid

返回:

客户信息 guide buyer relation

抛出:

WxErrorException - .