创意接口
查询创意
接口描述
查询创意信息
接口URL
http://sem.baidubce.com/v1/feed/cloud/CreativeFeedService/getCreativeFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
creativeFeedFields | array(string) | 需要查询的创意属性。属性名称即创意对象的字段名称。 |
idType | number | 查询条件ids字段的类型,1表示计划ID,2表示单元ID,3表示创意ID。 |
ids | array(number) | 需要查询的计划ID/单元ID/创意ID数组,最多填100个ID。 如果不填,则返回空数组。 |
creativeFeedFilter | object | 查询创意的筛选条件,定义见下。 |
查询创意的筛选条件(creativeFeedFilter字段)用于更精细地筛选查询的创意。目前仅支持按照创意状态筛选。字段如下:
字段名称 | 类型 | 描述 |
---|---|---|
status | array(number) | 需要筛选的创意状态。取值请参考创意对象的status字段说明。 |
说明: 如需要查询闪投创意,请使用闪投创意接口http://sem.baidubce.com/v1/feed/cloud/DpaCreativeFeedService/getCreativeFeed
响应参数说明
响应内容为创意对象数组,请参考其定义。
请求示例
POST /v1/feed/cloud/CreativeFeedService/getCreativeFeed HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"tgUsername": "example",
"bceUser": "example",
"opPassword": "example",
"tgPassword": "example"
},
"body": {
"idType": 3,
"ids": [
"54320498743"
],
"creativeFeedFields": [
"creativeFeedId",
"creativeFeedName",
"materialstyle",
"material"
"ideaType":0
]
}
}
响应示例
{
"body": {
"data": [
{
"creativeFeedId": 54320498743,
"creativeFeedName": "Creative1",
"materialstyle": 101,
"material": "{\"title\":\"使用信息流推广,获得好效果!\",\"brand\":\"百度\",\"url\":\"https://www.baidu.com/\",\"userPortrait\":\"http://example.com/example.jpg\",\"pictures\":[{\"image\":\"http://example.com/example.jpg\"}]}"
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
新增创意
接口描述
新增创意
接口URL
http://sem.baidubce.com/v1/feed/cloud/CreativeFeedService/addCreativeFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
creativeFeedTypes | array(object) | 创意对象数组,请参考其定义。 |
响应参数说明
响应为创意对象数组,请参考其定义。
响应结果中的创意对象与请求参数中一一对应(其中失败的不会包含在data中,但会在error中提供错误信息),且会包含新增成功的创意ID信息。
请求示例
POST /v1/feed/cloud/CreativeFeedService/addCreativeFeed HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"tgUsername": "example",
"bceUser": "example",
"opPassword": "example",
"tgPassword": "example"
},
"body": {
"creativeFeedTypes": [
{
"adgroupFeedId": 3739688195,
"creativeFeedName": "Creative1",
"materialstyle": 101,
"material": "{\"title\":\"使用信息流推广,获得好效果!\",\"brand\":\"百度\",\"url\":\"https://www.baidu.com/\",\"userPortrait\":\"http://example.com/example.jpg\",\"pictures\":[{\"image\":\"http://example.com/example.jpg\"}]}"
}
]
}
}
响应示例
{
"body": {
"data": [{
"creativeFeedId": 54320498743,
"adgroupFeedId": 3739688195,
"creativeFeedName": "Creative1",
"materialstyle": 101,
"material": "{\"title\":\"使用信息流推广,获得好效果!\",\"brand\":\"百度\",\"url\":\"https://www.baidu.com/\",\"userPortrait\":\"http://example.com/example.jpg\",\"pictures\":[{\"image\":\"http://example.com/example.jpg\"}]}"
}]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
程序化创意(程序化创意元素详情见创意物料说明中elements元素信息): 一个程序化创意可以拥有多个图片信息,多个标题信息,视频信息,等等,全部存在elements元素中,在此列出程序化创意新增示例。 请求示例
POST /v1/feed/cloud/CreativeFeedService/addCreativeFeed HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"tgUsername": "example",
"bceUser": "example",
"opPassword": "example",
"tgPassword": "example"
},
"body": {
"creativeFeedTypes": [{
"adgroupFeedId": 3739688195,
"materialstyle": 113,
"creativeFeedName": "Creative1",
"material": "{\"elements\":{\"titles\":[\"使用信息流推广,获得好效果!\"],\"singlePic\":[\"http://bj.bcebos.com/fc-feed/0/pic/8c7612b3cce925fa96cafb1c7142ad4c.jpg\"],\"largePic\":[],\"package3Pic\":[],\"horizontalVideos\":[],\"verticalVideos\":[]},\"brand\":\"百度\",\"userPortrait\":\"http://example.com/example.jpg\",\"url\":\"https://www.baidu.com/\",\"na_url\":\"\",\"monitor_url\":\"http://www.baidu.com/123\",\"subtitle\":\"222\"}"
}]
}
}
响应示例
{
"body": {
"data": [{
"creativeFeedId": 54320498743,
"adgroupFeedId": 3739688195,
"creativeFeedName": "Creative1",
"ideaType": 1,
"materialstyle": 113,
"showMt": 101,
"material": "{\"elements\":{\"titles\":[\"使用信息流推广,获得好效果!\"],\"singlePic\":[\"http://bj.bcebos.com/fc-feed/0/pic/8c7612b3cce925fa96cafb1c7142ad4c.jpg\"],\"largePic\":[],\"package3Pic\":[],\"horizontalVideos\":[], \"verticalVideos\":[]},\"brand\":\"百度\",\"userPortrait\":\"http://example.com/example.jpg\",\"url\":\"https://www.baidu.com/\",\"na_url\":\"\",\"monitor_url\":\"http://www.baidu.com/123\",\"subtitle\":\"222\"}"
}]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
更新创意
接口描述
更新创意信息
接口URL
http://sem.baidubce.com/v1/feed/cloud/CreativeFeedService/updateCreativeFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
creativeFeedTypes | array(object) | 创意对象数组,请参考其定义。 |
注意:请求参数中的创意ID为必填信息。
响应参数说明
响应为创意对象数组,请参考其定义。
请求示例
POST /v1/feed/cloud/CreativeFeedService/updateCreativeFeed HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"tgUsername": "example",
"bceUser": "example",
"opPassword": "example",
"tgPassword": "example"
},
"body": {
"creativeFeedTypes": [
{
"creativeFeedId": 54320498743,
"adgroupFeedId": 3739688195,
"creativeFeedName": "Creative1",
"materialstyle": 101,
"material": "{\"title\":\"使用信息流推广,获得好效果!\",\"brand\":\"百度\",\"url\":\"https://www.baidu.com/\",\"userPortrait\":\"http://example.com/example.jpg\",\"pictures\":[{\"image\":\"http://example.com/example.jpg\"}]}"
}
]
}
}
响应示例
{
"body": {
"data": [
{
"creativeFeedId": 54320498743,
"adgroupFeedId": 3739688195,
"creativeFeedName": "Creative1",
"materialstyle": 101,
"material": "{\"title\":\"使用信息流推广,获得好效果!\",\"brand\":\"百度\",\"url\":\"https://www.baidu.com/\",\"userPortrait\":\"http://example.com/example.jpg\",\"pictures\":[{\"image\":\"http://example.com/example.jpg\"}]}"
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
程序化创意(程序化创意元素详情见创意物料说明中elements元素信息): 一个程序化创意可以拥有多个图片信息,多个标题信息,视频信息,等等,全部存在elements元素中,在此列出程序化创意更新示例。 请求示例
POST /v1/feed/cloud/CreativeFeedService/updateCreativeFeed HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"tgUsername": "example",
"bceUser": "example",
"opPassword": "example",
"tgPassword": "example"
},
"body": {
"creativeFeedTypes": [{
"creativeFeedId": "54320498743",
"creativeFeedName": "Creative1",
"material": "{\"elements\":{\"titles\":[\"使用信息流推广,获得好效果!\"],\"singlePic\":[\"http://bj.bcebos.com/demo.jpg\"],\"largePic\":[],\"package3Pic\":[],\"horizontalVideos\":[],\"verticalVideos\":[]},\"brand\":\"百度\",\"userPortrait\":\"http://example.com/example.jpg\",\"url\":\"https://www.baidu.com/\",\"na_url\":\"\",\"monitor_url\":\"http://www.baidu.com/123\",\"subtitle\":\"sub\"}"
}]
}
}
响应示例
{
"body": {
"data": [{
"creativeFeedId": 54320498743,
"adgroupFeedId": 3739688195,
"creativeFeedName": "Creative1",
"materialstyle": 101,
"material": "{\"elements\":{\"titles\":[\"使用信息流推广,获得好效果!\"],\"singlePic\":[\"http://bj.bcebos.com/demo.jpg\"],\"largePic\":[],\"package3Pic\":[],\"horizontalVideos\":[],\"verticalVideos\":[]},\"brand\":\"百度\",\"userPortrait\":\"http://example.com/example.jpg\",\"url\":\"https://www.baidu.com/\",\"na_url\":\"\",\"monitor_url\":\"http://www.baidu.com/123\",\"subtitle\":\"sub\"}"
}]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
删除创意
接口描述
删除创意。
注意:删除后不可恢复,请谨慎操作。
接口URL
http://sem.baidubce.com/v1/feed/cloud/CreativeFeedService/deleteCreativeFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
creativeFeedIds | array(number) | 需要删除的创意ID。一次最多删除100个创意。 |
响应参数说明
响应为创意对象数组,但是仅包含被删除的创意ID信息。
请求示例
POST /v1/feed/cloud/CreativeFeedService/deleteCreativeFeed HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"tgUsername": "example",
"bceUser": "example",
"opPassword": "example",
"tgPassword": "example"
},
"body": {
"creativeFeedIds": [
54320498743,
54320498744,
54320498745
]
}
}
响应示例
{
"body": {
"data": [
{
"creativeFeedId": 54320498743
},
{
"creativeFeedId": 54320498744
},
{
"creativeFeedId": 54320498745
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
标题推荐
接口描述
标题推荐。
接口URL
http://sem.baidubce.com/v1/feed/cloud/TitleRecommendService/getTitle
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
query | string | 检索关键词。 |
sortField | string | 排序字段,默认为综合排序,取值为 addtime 时:收录时间排序,取值为 related 时:相关性排序。 |
sortOrder | string | 默认为降序 取值为 desc 时:为降序,取值为 asc 时:为升序。 |
pageNo | number | 分页的页码,从第一页开始。 |
pageSize | number | 指定每页展示多少条信息。 |
响应参数说明
字段名称 | 类型 | 描述 |
---|---|---|
totalCount | number | 标题总数量。 |
listData | array(object) | 标题对象数组,请参考其定义。 |
标题对象信息如下:
字段名称 | 类型 | 描述 |
---|---|---|
title | string | 标题名称 |
recommendTypeList | array(object) | 标题质量对象数组,请参考其定义。 |
salePoints | array(string) | 卖点信息。 |
qscore | number | 标题质量分(1~10)。 |
标题质量对象信息如下:
字段名称 | 类型 | 描述 |
---|---|---|
reasonType | number | 1:最新,2:最热,3:ctr提升,4:content的值飘红 。 |
content | string | 推荐数据,当reasonType=3时,代表提升数值;当reasonType=4时,代表飘红字段 。 |
请求示例
POST /v1/feed/cloud/TitleRecommendService/getTitle HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"tgUsername": "example",
"bceUser": "example",
"opPassword": "example",
"tgPassword": "example"
},
"body": {
"pageNo": 1,
"pageSize": 1,
"query": "摄影",
"sortField": "related",
"sortOrder": "desc"
}
}
响应示例
{
"body": {
"data": [{
"totalCount": 100,
"listData": [{
"title": "那些绝美的婚纱照原来是这样拍出来的?看到摄影师的拍摄过程简直笑喷了!",
"recommendTypeList": [{
"content": "原来是这样拍出来的?",
"reasonType": 4
}],
"salePoints": ["旅拍"],
"qscore": 10
}]
}]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
查询定投百青藤媒体的媒体侧审核信息
接口描述
查询定投百青藤媒体的媒体侧审核信息
接口URL
http://sem.baidubce.com/v1/feed/cloud/CreativeFeedService/getTargetMediaCreativeFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
targetMedia | number | (必填字段)定投媒体类型,1表示快手 |
idType | number | (必填字段)查询条件ids字段的类型,0表示账户ID,1表示计划ID,2表示单元ID,3表示创意ID。 |
ids | array(number) | 需要查询的账户ID/计划ID/单元ID/创意ID数组 idType传0即根据账户ID查询时,ids字段可以不传。其他情况如果不传ids,则返回空数组。 |
注意:当前仅支持查询当前账户ID下的媒体侧审核信息。
响应参数说明
字段名称 | 类型 | 描述 |
---|---|---|
creativeFeedId | number | 创意ID |
mediaAuditStatus | number | 媒体审核状态,0表示未审,1表示审核通过,2表示审核拒绝 |
mediaRefuseReason | string | 媒体审核拒绝理由 |
说明:如果未查询到定投百青藤媒体的媒体侧审核信息,则返回空数组。
请求示例
POST /v1/feed/cloud/CreativeFeedService/getTargetMediaCreativeFeed HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"tgUsername": "example",
"bceUser": "example",
"opPassword": "example",
"tgPassword": "example"
},
"body": {
"idType": 3,
"ids": [
54320498743
]
}
}
响应示例
{
"body": {
"data": [
{
"creativeFeedId": 54320498743,
"mediaAuditStatus": 1,
"mediaRefuseReason": ""
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}