创意模块接口

创意对象

创意对象定义了推广单元的所有属性,创意模块的多个接口均引用了其定义,请参考各接口的说明使用。

字段名称 类型 描述
creativeFeedId number 创意ID
adgroupFeedId number 所属推广单元ID
creativeFeedName string 创意名称
materialstyle number 创意样式ID,取值请参考创意样式列表
pause boolean 是否暂停推广
status number 创意状态。
此字段仅用于查询,新增/修改创意时参数中传此字段无效。
取值范围如下:
0:有效
1:暂停推广
2:审核中
3:审核未通过
4:无效(因与所属推广单元所选的投放版位不匹配而无法投放,推广单元修改投放版位后将自动重置此状态。请参考创意样式列表的说明。)
material string 物料内容。
物料内容为string形式的json对象,包含该创意所需的标题、图片、落地页URL等展示物料,以及监测URL等功能性物料。各种创意样式所需的物料字段有所不同,请参考创意物料说明创意样式列表
refusereason string 审核未通过的原因(审核拒绝理由)。原因可能有多个,该字段为string形式的json数组,数组元素为string类型,每个元素是一个原因。
示例:
"[\"原因A\",\"原因B\"]"
ideaType number 返回的创意类型,取值0代表自定义创意 1代表程序化创意

查询创意

接口描述

查询创意信息

接口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字段说明。

响应参数说明

响应内容为创意对象数组,请参考其定义。

请求示例

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"
        ],
   &nb