意图词包接口

更新时间：2020-03-17

意图词包对象

查询意图词包接口会返回意图词包信息，添加或者更新意图词包需要填写意图词包信息，包含如下字段：

字段名称	类型	描述
wtpId	number	意图词包id
wtpName	string	意图词包名称
keywords	string	意图词
~~estimate~~	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	词包内容
~~estimate~~	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	意图词	必填
~~estimate~~	预估覆盖率	无效

响应参数说明

响应为意图词包数组，请参考其定义。

请求示例

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	意图词	选填
~~estimate~~	预估覆盖率	无效
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
  }
}

人群包接口

查询APP偏好定向所需的APPID

意图词包接口

意图词包对象

查询推荐意图词包

获取意图词包

添加意图词包

更新意图词包

删除意图词包

查询意图标签过滤条件

查询意图标签

产品与文档反馈

提交失败

温馨提示

提交成功

温馨提示