添加创意
添加创意
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 |