商品组模块
更新时间：2019-10-10
闪投商品组相关对象
商品字段对象
商品字段对象定义了商品文件/商品组内可使用的商品字段列表。
| 字段名称 | 类型 | 描述 |
|---|---|---|
| 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
}
}