# 设置屏蔽的广告主
接口应在服务器端调用,详细说明参见服务端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 | 屏蔽安卓应用输入应用宝包名错误 | 检查输入应用宝包名是否正确 |