百度信息流推广API

    商品组模块

    闪投商品组相关对象

    商品字段对象

    商品字段对象定义了商品文件/商品组内可使用的商品字段列表。

    字段名称 类型 描述
    value string
    例:name
    label number 标签
    例:产品库系统ID
    description string 描述
    conditions array(object) 商品字段可支持的筛选关系,参考商品字段筛选关系定义。

    商品字段筛选关系

    商品字段筛选关系,定义了特定字段所支持筛选关系的说明。

    字段名称 类型 描述
    label string 操作符名称
    例:不等于
    value string 操作符类型
    例:NOT_EQUAL

    示例:

    {
        "label": "等于",
        "value": "EQUAL"
    }

    闪投商品组对象

    目前,闪投推荐单元都需要绑定一个投放商品组。闪投商品组对象定义了商品组的一些基本属性,便于用户在编辑闪投推广单元时,选择合适的商品进行投放。

    字段名称 类型 描述
    productSetId number 商品组ID
    productSetName string 商品组名称
    feedId number 商品文件ID
    feedName string 商品文件名称
    catalogId number 商品目录ID
    catalogName string 商品目录名称

    根据idType查询特定场景下商品库字段

    接口描述

    根据id和idType查询特定场景下

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/DpaProductSetService/getProdFieldsByType

    请求参数说明

    字段名称 类型 描述
    id number ID有效值,必填。
    idType number ID类型,必填。
    取值范围
    2:单元ID,返回值同上接口 ; 5: 商品目录ID

    响应参数说明

    字段名称 类型 描述
    prodFields array(object) 商品推广对象数组,参考商品字段对象定义。

    请求示例

    POST /v1/feed/cloud/DpaProductSetService/getProdFields 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": {
    		"id": 5000214,
        "idType": 5
        }
    }

    响应示例

    {
    	"body": {
    		"data": [
    			{
                    "prodFields": [
                        {
                            "value": "name",
                            "label": "商品名称",
                            "description": null,
                            "conditions": [
                                {
                                    "label": "等于",
                                    "value": "EQUAL"
                                },
                                {
                                    "label": "不等于",
                                    "value": "NOT_EQUAL"
                                },
                                {
                                    "label": "包含",
                                    "value": "CONTAIN"
                                },
                                {
                                    "label": "不包含",
                                    "value": "NOT_CONTAIN"
                                }
                            ]
                        },
                        {
                            "value": "attributes.pcLoc",
                            "label": "商品PC端URL",
                            "description": null,
                            "conditions": [
                                {
                                    "label": "等于",
                                    "value": "EQUAL"
                                },
                                {
                                    "label": "不等于",
                                    "value": "NOT_EQUAL"
                                },
                                {
                                    "label": "包含",
                                    "value": "CONTAIN"
                                },
                                {
                                    "label": "不包含",
                                    "value": "NOT_CONTAIN"
                                }
                            ]
                        }
                    ]
                }
    		]
    	},
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    查询闪投账户下所有商品组

    接口描述

    查询账户下可使用的商品组信息,包括商品库文件商品组知识库文件商品组

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/DpaProductSetService/getAllProductSets

    请求参数说明

    字段名称 类型 描述
    type number 商品文件类型,必填。
    取值范围
    0: 商品库文件类型 1: 知识库文件类型

    响应参数说明

    响应内容为闪投商品组对象数组,请参考其定义。

    请求示例

    POST /v1/feed/cloud/DpaProductSetService/getAllProductSets 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":{
            "type":1
        }
    }

    响应示例

    {
        "body":{
            "data":[
                {
                    "productSetId":5255,
                    "productSetName":"12345",
                    "feedId":1311,
                    "feedName":"知识库",
                  	"catalogId": 0,
                  	"catalogName": null
                },
                {
                    "productSetId":5401,
                    "productSetName":"勾选前3",
                    "feedId":1311,
                    "feedName":"知识库",
                  	"catalogId": 0,
                  	"catalogName": null
                },
                ......
            ]
        },
        "header":{
            "oprs":1,
            "failures":[
    
            ],
            "succ":1,
            "oprtime":0,
            "desc":"success",
            "status":0
        }
    }

    查询商品组可字段列表

    接口描述

    查询商品组可用字段列表,已废弃,请使用getProdFieldsByType新接口

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/DpaProductSetService/getProdFields

    请求参数说明

    字段名称 类型 描述
    id number 单元id

    响应参数说明

    字段名称 类型 描述
    prodFields array(object) 商品推广对象数组,参考商品字段对象定义。

    请求示例

    POST /v1/feed/cloud/DpaProductSetService/getProdFields 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": {
    		"id": 739950625
        }
    }

    响应示例

    {
    	"body": {
    		"data": [
    			{
                    "prodFields": [
                        {
                            "value": "name",
                            "label": "名称",
                            "description": null,
                          	"conditions": null
                        },
                        {
                            "value": "wiseUrl",
                            "label": "商品移动端URL",
                            "description": null,
                            "conditions": null
                        }
                    ]
                }
    		]
    	},
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }
    上一篇
    创意模块接口
    下一篇
    报告模块