更新流量投放状态
需要携带 Token,详情看 Token
通过此接口可用于控制流量(即,mtgid)在广告单元中的跑量状态。另外,该操作受权限管控,若权限不足,接口会返"Permission denied"
,请联系 AM 授权后再试操作。
请求地址
https://ss-api.mintegral.com/api/open/v1/offer/target
请求方法
PUT
请求示例
json
PUT /api/open/v1/offer/target
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
"offer_id": 1234,
"option": "ENABLE",
"mtgid": "mtg1127838375"
}
请求参数
字段 | 类型 | 说明 | 默认值 | 例子 |
---|---|---|---|---|
offer_id | int | 广告单元 ID | — | 1234 |
option | string | 广告单元下需要优化的流量的 mtgid 的新状态。可选值:"ENABLE" 、"DISABLE" 、"ALLOW_ALL" 。ENABLE :表示将某个 mtgid 添加进白名单或者将某个 mtgid 从黑名单剔除 DISABLE : 表示将某个 mtgid 添加进黑名单或者将某个 mtgid 从白名单剔除。 ALLOW_ALL:表示恢复所有 App 的投放状态,取消黑白名单的设置。 广告单元里需要优化的流量 mtgid。如果 mtgid 传空,则清空黑白名单。多个用,号分隔,最多 3000 个。 | — | "DISABLE" |
mtgid | string | 广告单元里需要优化的流量 mtgid。如果 mtgid 传空,则清空黑白名单。多个用,号分隔,最多 3000 个。 注: 该接口采取全量更新方式,请提交完整的黑白名单设置。 | — | "mtg1127838375" |
响应结果
字段 | 类型 | 说明 |
---|---|---|
code | int | 200 表示成功 其他表示失败 |
msg | string | 成功,返回"success",失败返回相应的错误信息 |
data | json | 成功,返回 null,失败返回具体的错误信息 |
应答示例
json
{
"msg": "success",
"code": 200,
"data": null
}