百度信息流推广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
    	}
    }
    上一篇
    创意对象
    下一篇
    创意预览接口