更新创意

HTTP请求方式

POST

请求地址

https://api.e.360.cn/dianjing/creative/update

Headers请求参数
字段 类型 必须 描述
apiKey String Yes 注册时分配到的api key，该参数作为HTTP HEAD字段传递。
accessToken String Yes 身份认证通过后平台分配的临时token，作为操作对应广告账户的凭证，10小时有效。参数获取方式见接口clientLogin。
Body请求参数
字段 类型 必须 描述
creatives String Yes JSON 格式的创意对象数组，单次请求提交数量最多 500 个。每个创意对象可包含多个属性，其中id不能为空，不做修改的字段不上传，但如果修改的字段为description1时，description2和descSecondLine的原值则需要上传（仅修改description2或descSecondLine时同上，description1的原值也需要上传)
creatives示例
[{
        "id": 123456,
        "title": "创意标题 1",
        "description1": "创意描述1-1",
        "description2": "创意描述的一部分，当广告在右侧展示时，该部分会被截掉，以免广告过长影响展示效果，不影响左侧广告",
        "descSecondLine": "其实我是第二行创意",
        "destinationUrl": "http://www.360.cn",
        "displayUrl": "",
        "mobileDestinationUrl": "http://m.360.cn/1.html",
        "mobileDisplayUrl": "http://m.360.cn",
        "status": "enable"
    },
    {
        "id": 987654,
        "title": "创意标题2",
        "displayUrl": "http://360.cn",
        "status": "pause"
    }
]
creatives字段说明
字段 类型 必须 描述
id int Yes 创意id
title string No 创意标题
description1 string No 创意描述第一行
description2 string No 和description1拼接后提交到创意描述第一行
descSecondLine string No 创意描述第二行
destinationUrl string No pc端跳转连接地址
displayUrl string No pc端显示地址
mobileDestinationUrl string No 移动端跳转连接地址
mobileDisplayUrl string No 移动端显示地址
deeplinkUrl string No 应用调起网址 (账户需要开通对应权限)
status string No 启用/暂停状态，enable-启用，pause-暂停，默认启用
请求示例
curl -X POST \ 
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--data 'creatives=[{"id":5230552939 ,"title":"创意标题auto_exec","displayUrl":"http://360.cn","status":"pause"}]' \ 
'https://api.e.360.cn/dianjing/creative/update'
返回结果
{
    "affectedRecords":1,
    "failCreativeIds":"[]",
    "failures":[]
}
返回结果说明
字段 类型 描述
affectedRecords int 更新成功的创意个数
failCreativeIds array 如果部分创意提交的数据不合法，相应的id会在返回结果中列出，不影响其他创意的更新

results matching ""

    No results matching ""