创意接口

更新时间：2020-07-06

查询创意

接口描述

查询创意信息

接口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
	}
}

创意对象

创意预览接口

百度信息流推广API

创意接口

查询创意

新增创意

更新创意

删除创意

标题推荐

查询定投百青藤媒体的媒体侧审核信息