本节将通过一个实际案例，对标签画像API功能的使用方法及流程进行梳理，更好的方便用户了解标签画像API的使用流程。

标签服务API功能是标签画像在服务层的重点功能之一，可以通过API的方式将标签和群组的数据进行共享，实现与应用层营销系统的数据互通。

标签画像API的功能借助Easydata产品体系下的"数据服务"产品实现，"数据服务"是一款提供安全稳定的API快速构建能力、提高数据开发和运维效率的产品，复用数据服务丰富的调用数据监控、报警机制、流控策略等功能实现标签画像API的构建和使用。

标签画像API功能由于涉及到"标签画像"和"数据服务"两款产品，且由于两个产品间的管理单位不一样，故需要做好以下功能权限的管理工作：

其次，标签画像API功能只在标签工作组为"Hive"执行引擎才支持，"ES"执行引擎的工作组暂不支持标签画像API功能。

创建标签画像API步骤说明

在标签画像侧：

前提：

步骤：

在数据服务侧：

前提：

步骤：

下面将从标签画像侧创建标签/群组到生成标签画像API进行测试、发布整个流程，结合产品功能界面，讲述标签画像API的整个流程。

首先创建对象，构建标签模型，详细步骤可参阅对象管理.

然后可以创建标签类型为基础、复合和人工的标签，不同类型的标签区别，详细说明可参阅 标签类型。

标签创建成功后，将标签进行发布。如下所示，在归属对象为"用户"下创建了包括教育程度、籍贯省份、用户等级、职业等已发布态的标签。

在群组管理模块，基于标签规则创建了"已婚的高学历人才"的群组，如下图所示，更多有关群组不同创建方式的说明可参与 新建群组。

群组创建成功后，在群组列表可查看创建成功的群组。且在计算状态为"计算成功"的条件下，可在操作列，选择"更多"中的"生成群组API"快捷的进入数据服务新建API的页面。

在群组详情页面，右上角也支持点击"生成群组API"快捷进入数据服务新建API的页面。

需要注意的是：只有当群组最新一次实例计算状态为“计算成功”，才支持点击"生成群组API"的功能，否则无法进入新建API的页面

若想要通过直连群组表的方式获取群组数据，也可以在群组详情页面的"覆盖数历史详情"中查看每次实例运行中生成的群组表，结合"群组表生命周期"功能，管理冗余的群组表。

进入数据服务新建标签画像API的页面有以下几种途径：

标签画像API支持两种类型，包括标签API和群组API，可以将已发布的标签或计算成功的群组数据生成API。

创建标签画像API包含三个步骤：配置基础信息、选择归属对象下已发布的标签或最近一次计算状态为成功的群组配置参数、在线测试。

第一步配置基础信息，若标签画像API类型选择的是"标签API"，则支持设置入参，其他字段内容同"新建API"的内容。

第一步选择的是"标签API"，第二步就可以选择归属对象下已发布的标签作为返回参数、排序参数，也可以结合第一步创建的入参设置请求参数。

其中，需要注意的是：

查询引擎：数据服务查询标签数据使用的查询引擎，默认为Impala； impala集群和执行队列：可用的当前项目下的Impala引擎对应的集群和队列； 选择集群：用来唯一定位标签画像侧的工作组。由于标签侧是以"项目组+集群"管理所有工作组，在项目组-集群下又创建多个工作组管理标签；而数据服务是以"项目"为单位管理API，故需要结合"集群"信息，定位标签画像侧当前项目组下的工作组。 工作组：即标签画像侧管理标签的空间名称； 归属对象：标签/群组所归属的对象。

第三步就可以对API进行在线测试，查看请求结果、耗时和返回的内容。

第一步配置基础信息，若标签画像API类型选择的是"群组API"，则不需要设置入参，其他字段内容同"新建API"的内容。

第一步选择的是"群组API"，第二步就可以选择归属对象下最新一次计算状态为成功的群组，选择群组中的标签字段配置返回和排序参数。

选择的查询引擎和集群含义同"标签API"类型，选择归属对象后，还需要选择该对象下最新一次计算状态为"计算成功"的群组。

同样，第三步对群组API进行在线测试，查看请求结果、耗时和返回内容。

对测试成功的标签API和群组API进行发布，发布后的API就可以绑定应用进行API的调用了。

数据服务侧支持apiToken和APPkey/appsecret两种鉴权方式，本示例以BI报表连接群组API为例，展示调用标签画像API的功能流程。

说明：若想要用BI报表的方式连接API，在创建API时需开启 apiToken鉴权功能。更多API调用的说明，可参阅数据服务产品的使用手册说明。

如下所示，填写header中所需字段，从群组API详情页复制URL地址，从绑定的应用详情页复制apiToken，连接群组API获取数据：