商品组模块
所有文档

          百度信息流推广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
          	}
          }
          上一篇
          创意模块接口
          下一篇
          报告模块