# shopping-guide.addGuideBuyerTag

本接口应在服务器端调用，详细说明参见服务端API。

为客户设置标签

单次请求接口，可选择一次设置一个客户（传openid）或者一次设置多个客户（传openid_list）

# 请求地址

POST https://api.weixin.qq.com/cgi-bin/guide/addguidebuyertag?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
guide_account	string	是	顾问微信号（guide_account和guide_openid二选一）
guide_openid	string	是	顾问openid或者unionid（guide_account和guide_openid二选一）
openid	string	否	客户openid
tag_value	string	是	标签的可选值，该值必须在标签的可选值集合中
openid_list	Array.<string>	否	客户列表，不超过200，openid和openid_list二选一

# 返回值

# Object

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
buyer_resp	Array.<Object>	客户列表添加结果，当请求openid_list列表大于0有意义

buyer_resp的结构

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
openid	string	请求里的buyer_list客户openid

errcode 的合法值

值	说明	最低版本
0	成功
-1	系统失败
40003	无效的openid
43004	没有关注该服务号
9300801	无效的微信号
9300804	该微信号不是顾问
9300806	客户和顾问不存在绑定关系
9300807	可选值无效，不是标签的可选值

# 请求数据示例

{
  "guide_account": "wx_account",
  "openid": "xxxxxxx",
  "tag_value": "tag1"
}

或者

{
  "guide_account": "wx_account",
  "openid_list": [
        "xxxxxxx",
        "yyyyyyyy"
  ],
  "tag_value": "tag1"
}

# 返回数据示例

{
  "errcode": 0,
  "errmsg": "ok"
}

或者

{
  "errcode": 0,
  "errmsg": "ok",
  "buyer_resp": {
    [
        "errcode": 0,
        "errmsg": "ok",
        "openid": "xxxxxxx"
    ],
    [
        "errcode": 0,
        "errmsg": "ok",
        "openid": "yyyyyyyy"
    ]
  }
}