添加创意
添加创意
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/creative/add
| 字段 |
类型 |
必须 |
描述 |
| Content-Type |
string |
yes |
application/x-www-form-urlencoded |
| apiKey |
string |
yes |
注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
| accessToken |
string |
yes |
访问token |
Body 请求参数
| 字段 |
类型 |
必须 |
描述 |
| creatives |
string |
yes |
JSON 格式的创意对象数组,单次请求提交数量最多 500 个 |
creatives示例
[{
"groupId": 123456,
"title": "创意标题 1",
"description1": "创意描述1-1",
"descSecondLine": "第二行创意",
"destinationUrl": "http://www.360.cn",
"displayUrl": ""
},
{
"groupId": 987654,
"title": "创意标题2",
"description1": "创意描述2-1",
"description2": "创意描述2-2",
"descSecondLine": "第二行创意",
"destinationUrl": "http://www.360.cn",
"displayUrl": "http://www.360.cn",
"mobileDestinationUrl": "http://m.360.cn/top.html",
"mobileDisplayUrl": "http://m.360.cn",
"status": "pause"
}
]
creatives字段说明
| 字段 |
类型 |
必须 |
描述 |
| groupId |
int |
Yes |
推广组id |
| title |
string |
Yes |
创意标题 |
| description1 |
string |
Yes |
创意描述第一行 |
| description2 |
string |
No |
和description1拼接后提交到创意描述第一行 |
| descSecondLine |
string |
No |
创意描述第二行 |
| destinationUrl |
string |
No |
pc端跳转连接地址,投PC+移动的计划的创意该项为必填项 |
| displayUrl |
string |
No |
pc端显示地址,投PC+移动的计划的创意该项为必填项 |
| mobileDestinationUrl |
string |
Yes |
移动端跳转连接地址 |
| mobileDisplayUrl |
string |
Yes |
移动端显示地址 |
| deeplinkUrl |
string |
No |
应用调起网址 (账户需要开通对应权限) |
| status |
string |
Yes |
启用/暂停状态,enable-启用,pause-暂停,默认启用 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'creatives=[{"groupId":1810342237,"title":"auto创意标题 1","description1":"创意描述1-1","descSecondLine":"第二行创意","destinationUrl":"http://www.360.cn","displayUrl":""}]' \
'https://api.e.360.cn/dianjing/creative/add'
返回结果
{
"creativeIdList":[5145334164],
"failures":[]
}
返回结果说明
| 字段 |
类型 |
描述 |
| creativeIdList |
String |
新增的创意id数组,如果某个创意插入失败,对应的id为0 |