Skip to content

更新素材

需要携带 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_idint广告单元 ID123
ad_typestring广告类型,多个用,号分隔。可选值:[枚举值 - 广告展示类型(图片)][枚举值 - 广告展示类型(视频)]"REWARDED_VIDEO"
creativearray<json>
creative_md5string上传素材后获取的md5值。"0a6335cd9151ac5dc79ad996f4e12674"
creative_namestring上传素材后获取的的素材名称,素材名称,默认为文件名,必须为字母、数字、下划线"creative_test.png"
apply_in_areastring素材投放的地区。如果投放所有地区,填写”ALL”,如果分地区,多个地区用,号分隔。"CN,EN"
creative_set_name 选填string素材组名称"default"
optionstring素材状态。该参数缺省表示状态不变。可选值:"ENABLE" 、"DISABLE" 。ENABLE  表示素材可用于广告单元推广,DISABLE 表示关停素材,指定素材不可在广告单元的推广中使用。注:新素材必须设置为 ENABLE 。"DISABLE"

响应结果

字段类型说明
codeint200 表示成功,其他表示失败
msgstring成功,返回"success",失败返回相应的错误信息
datajson成功,返回"success",失败返回具体的错误信息

应答示例

json
{
  "msg": "success",
  "code": 200,
  "data": ["success"]
}