商品组模块
更新时间: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
}
}