所有文档

          百度信息流推广API

          创意接口

          查询创意

          接口描述

          查询创意信息

          接口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
          	}
          }
          上一篇
          创意对象
          下一篇
          创意预览接口