更新素材
需要携带 Token,详情看 Token
通过此接口可用于更新广告单元里的广告类型定向以及素材投放状态。
素材尺寸要求详情查看附录 [附录 - 素材尺寸] 。
此接口即将废弃,请使用接口协议 - 创建创意组
请求地址
https://ss-api.mintegral.com/api/open/v1/offer/apply_creative
请求方法
PUT
请求示例
json
PUT /api/open/v1/offer/apply_creative
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
"offer_id": 123,
"ad_type": "REWARDED_VIDEO",
"creative": [
{
"creative_md5":"0a6335cd9151ac5dc79ad996f4e12674",
"creative_name":"creative_test.png" ,
"apply_in_area": "CN,EN",
"option": "ENABLE"
}
]
}
请求参数
字段 | 类型 | 说明 | 默认值 | 例子 |
---|---|---|---|---|
offer_id | int | 广告单元 ID | — | 123 |
ad_type | string | 广告类型,多个用,号分隔。可选值:[枚举值 - 广告展示类型(图片)][枚举值 - 广告展示类型(视频)] | — | "REWARDED_VIDEO" |
creative | array<json> | |||
creative_md5 | string | 上传素材后获取的md5值。 | — | "0a6335cd9151ac5dc79ad996f4e12674" |
creative_name | string | 上传素材后获取的的素材名称,素材名称,默认为文件名,必须为字母、数字、下划线 | — | "creative_test.png" |
apply_in_area | string | 素材投放的地区。如果投放所有地区,填写”ALL”,如果分地区,多个地区用,号分隔。 | — | "CN,EN" |
creative_set_name 选填 | string | 素材组名称 | — | "default" |
option | string | 素材状态。该参数缺省表示状态不变。可选值:"ENABLE" 、"DISABLE" 。ENABLE 表示素材可用于广告单元推广,DISABLE 表示关停素材,指定素材不可在广告单元的推广中使用。注:新素材必须设置为 ENABLE 。 | — | "DISABLE" |
响应结果
字段 | 类型 | 说明 |
---|---|---|
code | int | 200 表示成功,其他表示失败 |
msg | string | 成功,返回"success",失败返回相应的错误信息 |
data | json | 成功,返回"success",失败返回具体的错误信息 |
应答示例
json
{
"msg": "success",
"code": 200,
"data": ["success"]
}