意图词包接口
意图词包对象
查询意图词包接口会返回意图词包信息,添加或者更新意图词包需要填写意图词包信息,包含如下字段:
字段名称 | 类型 | 描述 |
---|---|---|
wtpId | number | 意图词包id |
wtpName | string | 意图词包名称 |
keywords | string | 意图词 |
number | 预估覆盖率,范围为:0-100 | |
hot | number | 覆盖度 |
wordCount | number | 意图词个数 |
查询推荐意图词包
接口描述
查询推荐意图词包。
接口URL
http://sem.baidubce.com/v1/feed/cloud/SearchFeedService/getRecmWordPackagesFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
query | string | 需要查询词包的关键词 |
planid | number | 计划id |
unitid | number | 单元id |
响应参数说明
响应数据为推荐意图词包的数组。推荐意图词包结构如下:
字段名称 | 类型 | 描述 |
---|---|---|
packageName | string | 词包名称 |
keyWords | string | 词包内容 |
number | 预估人群覆盖率,数据为百分比值体现 | |
hot | number | 覆盖度 |
请求示例
POST /v1/feed/cloud/SearchFeedService/getRecmWordPackagesFeed 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": {
"query":"麦凯瑞大学",
"planid":96279345
}
}
响应示例
{
"body": {
"data": [
{
"packageName":"大学",
"keyWords":[""浙江大学大学自考","中国大学自考"],
"estimate":0.2186847271261184,
"expmask":256,
"hot":2000
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
获取意图词包
接口描述
查询意图词包。
接口URL
http://sem.baidubce.com/v1/feed/cloud/WtpFeedService/getWtpFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
wtpIds | array(number) | 查询意图词包id集合; 必填,最多200个 |
wtpIds传[]时,可以查询当前账户下所有意图词包。
响应参数说明
响应内容为意图词包数组,请参考其定义。
请求示例
POST /v1/feed/cloud/WtpFeedService/getWtpFeed 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": {
"wtpIds": [12345]
}
}
响应示例
{
"body": {
"data": [
{
"wtpId":77120141613,
"wtpName":"品牌手游",
"keywords":"我的宠物 修改版,巴啦啦魔法变身2,红警2共和国崛起",
"estimate":0.2550926296986312,
"hot":5688,
"wordCount":3
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
添加意图词包
接口描述
添加意图词包(可批量)。
接口URL
http://sem.baidubce.com/v1/feed/cloud/WtpFeedService/addWtpFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
wtpFeedTypes | array(object) | 新增的意图词包数组,最多200个 |
请求参数限制
字段名称 | 类型 | 描述 |
---|---|---|
wtpId | 意图词包id | 无效 |
wtpName | 意图词包名称 | 必填 |
keywords | 意图词 | 必填 |
预估覆盖率 | 无效 |
响应参数说明
响应为意图词包数组,请参考其定义。
请求示例
POST /v1/feed/cloud/WtpFeedService/addWtpFeed 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": {
"wtpFeedTypes": [
{
"wtpName":"品牌手游",
"keywords":"我的宠物 修改版,巴啦啦魔法变身2,红警2共和国崛起",
}
]
}
}
响应示例
{
"body": {
"data": [
{
"wtpId":77120141613,
"wtpName":"品牌手游",
"keywords":"我的宠物 修改版,巴啦啦魔法变身2,红警2共和国崛起",
"estimate":0.2550926296986312,
"hot":5688,
"wordCount":3
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
更新意图词包
接口描述
更新意图词包(可批量)。
接口URL
http://sem.baidubce.com/v1/feed/cloud/WtpFeedService/updateWtpFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
wtpFeedTypes | array(object) | 更新的意图词包数组,最多200个 |
更新WtpFeedType的参数限制如下
字段名称 | 类型 | 描述 |
---|---|---|
wtpId | 意图词包id | 必填 |
wtpName | 意图词包名称 | 选填 |
keywords | 意图词 | 选填 |
预估覆盖率 | 无效 | |
hot | 覆盖度 | 无效 |
wordCount | 意图词个数 | 无效 |
响应参数说明
响应为意图词包数组,请参考其定义。
请求示例
POST /v1/feed/cloud/WtpFeedService/updateWtpFeed 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": {
"wtpFeedTypes": [
{
"wtpId":77120141613,
"wtpName":"品牌手游+1",
"keywords":"我的宠物 修改版+1,巴啦啦魔法变身2+1,红警2共和国崛起+1"
}
]
}
}
响应示例
{
"body": {
"data": [
{
"wtpId":77120141613,
"wtpName":"品牌手游+1",
"keywords":"我的宠物 修改版+1,巴啦啦魔法变身2+1,红警2共和国崛起+1",
"hot":5200,
"wordCount":3
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
删除意图词包
请求描述
删除指定的意图词包(可批量)
接口URL
http://sem.baidubce.com/v1/feed/cloud/WtpFeedService/deleteWtpFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
wtpIds | array(number) | 意图词包id数组,最多200个 |
响应参数说明
字段名称 | 类型 | 描述 |
---|---|---|
wtpFeedTypes | array(object) | 删除成功的意图词包数组,仅包含意图词包ID字段 |
请求示例
POST /v1/feed/cloud/WtpFeedService/deleteWtpFeed 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": {
"wtpIds": [77120141613]
}
}
响应示例
{
"body": {
"data": [
{
"wtpId":77120141613
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
查询意图标签过滤条件
接口描述
查询意图标签过滤条件,用于查询意图标签接口的参数。
接口URL
http://sem.baidubce.com/v1/feed/cloud/SearchFeedService/getIntentTagFilterFeed
请求参数说明
无
响应参数说明
响应为树形结构,分为行业、行为、品类三个级别。请参考如下描述和示例。
字段名称 | 类型 | 描述 |
---|---|---|
level | string | 级别,第一级为"industry"表示行业,第二级为"behavior"表示行为,第三级为"category"表示品类 |
conditions | array(string) | 可选条件的列表。 |
filters | array(object) | 下级节点列表。 |
请求示例
POST /v1/feed/cloud/SearchFeedService/getIntentTagFilterFeed 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": {
}
}
响应示例
{
"body": {
"data": [
{
"level": "industry",
"conditions": [
"游戏"
],
"filters": [
{
"level": "behavior",
"conditions": [
"想玩",
...
],
"filters": [
{
"level": "category",
"conditions": [
"手机游戏",
...
]
},
...
]
},
...
]
},
...
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
查询意图标签
接口描述
查询意图标签,用于意图标签定向设置。
接口URL
http://sem.baidubce.com/v1/feed/cloud/SearchFeedService/getIntentTagFeed
请求参数说明
请求字段中行业、行为、类目条件的可选值请使用查询意图标签过滤条件接口获取。
字段名称 | 类型 | 描述 |
---|---|---|
industry | string | 行业条件。必填。 |
behavior | string | 行为条件。必填。 |
category | string | 类目条件。必填。 |
query | string | 意图标签关键词。即模糊查询包含该关键词的意图标签。该字段为可选字段。 |
响应参数说明
响应为意图标签数组。
字段名称 | 类型 | 描述 |
---|---|---|
industry | string | 行业。 |
name | string | 意图标签名称。 |
请求示例
POST /v1/feed/cloud/SearchFeedService/getIntentTagFeed 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": {
"industry":"游戏",
"behavior":"想玩",
"category":"手机游戏",
"query":"射击",
}
}
响应示例
{
"body": {
"data": [
{
"industry": "游戏",
"name": "想玩射击游戏"
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}