# 设置屏蔽的广告主

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

# 接口说明

# 接口英文名

SetBlackList

# 功能描述

该 API 用于设置小程序广告屏蔽的广告主。使用过程中如遇到问题,可在开放平台服务商专区交流专区 | 微信开放社区发帖交流。

# 注意事项

其中access_token为authorizer_access_token

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wxa/operationams?action=agency_set_black_list&access_token=xxxxxxxxxxxxxxx 

# 请求参数

属性 类型 必填 说明
op number 1:设置屏蔽 2:删除屏蔽
list string 为json序列化格式,包含屏蔽类型type及标识ID。其中,type枚举值:1:公众号,id代表公众号微信号 2:IOS应用,id代表IOS应用APPID 3:安卓应用,id代表安卓应用的应用宝包名 4:小程序/小游戏,id代表原始ID。注:屏蔽数量有上限,超过将超时报错。公众号,最多可屏蔽20个,iOS应用,最多可屏蔽10个,安卓应用,最多可屏蔽10个,小程序/小游戏,最多可屏蔽20个

# 返回参数

属性 类型 说明
ret number 错误码
err_msg string 错误信息

# 调用示例

示例说明: HTTPS请求

# 请求数据示例


{
    "op": 1,
    "list": "[{\"type\":1,\"id\":\"gh_f23fc177abe4\"}]"
} 

# 返回数据示例


{
    "ret": 0,
    "err_msg": "" // 仅在接口调用失败返回
} 

# 错误码

错误码 错误码取值 解决方案
0 ok ok
1700 参数错误 检验输入参数是否符合文档说明
1701 参数错误 检验输入参数是否符合文档说明
1735 商户未完成协议签署流程 完成签约操作
1737 操作过快 等待一分钟后重新操作
1807 无效流量主 通过开通流量主接口为该appid开通流量主
2009 无效流量主 通过开通流量主接口为该appid开通流量主
2035 超过某类型广告主屏蔽上限 移除不需再屏蔽的广告主
2056 服务商未在变现专区开通账户 在第三方平台页面的变现专区开通服务
3004 公众号广告主屏蔽输入微信号错误 检查输入微信号是否正确
3005 小程序小游戏广告主输入原始ID错误 检查输入原始ID是否正确
3006 屏蔽IOS应用输入APPID错误 检查输入APPID是否正确
3007 屏蔽安卓应用输入应用宝包名错误 检查输入应用宝包名是否正确