用户标签用户列表查询

接口说明

查询空间中指定用户标签覆盖用户的用户特征

接口地址

http://{api-host}/v1/api/projects/{projectId}/spaces/{spaceId}/user_tags/{tagKey}/users

请求方式

GET

公共请求参数

公共请求参数

请求参数

名称	类型	必填	描述	示例值
projectId	String	是	用户标签所在项目 ID	WlGk4Daj
spaceId	String	是	用户标签所在空间 ID	VKwkPmqX
tagKey	String	是	用户标签标识符	tag_rfm

查询参数

名称	类型	必填	描述	示例值
limit	Int	否	单次查询返回数据上限 最大值为 1,000 默认值为 1,000	1000
offset	Int	否	查询标识位，默认值为 0	0、10000、20000
properties[]	String	否	查询的用户身份、用户属性、用户标签 最大查询 20 个，超过上限后查询失败	id_$basic_userId

返回数据

名称	类型	描述
limit	Int	单次查询返回数据上限
offset	Int	查询标识位
totalCount	Int	本次查询总计返回数据量
hasNextPage	Bool	是否有下一页 false：否 true：是
hasPreviousPage	Bool	是否有上一页 false：否 true：是
values	Objective	群体画像查询数据

values 数据

名称	类型	描述
gioId	Int	GrowingIO 系统生成的用户标示
identifications	< String , List >	查询的用户身份值
properties	Objective	查询的用户属性和用户标签值

示例 1：用户标签标识符不存在或未授权该项目

场景：根据项目 ID WlGk4Daj 空间 ID VKwkPmqX 搜索 未定义 或 未授权 的用户标签 tag_rfm 的用户 ID，单次查询返回数据上限为 100，标识位为 0。

请求示例

curl --location --request GET 'http://{api-host}/v1/api/projects/WlGk4Daj/spaces/VKwkPmqX/user_tags/tag_rfm/users?limit=100&offset=0&properties[]=ids_$basic_userId'
--header 'Authorization: Bearer c2ff9aa1-1824-4cc7-a01f-4094293a6af9'

返回示例

Internal Server Error

示例 2：搜索条件未输入用户身份、用户属性、用户标签

场景：根据项目 ID WlGk4Daj 空间 ID VKwkPmqX 搜索 群体画像 tag_rfm ,单次查询返回数据上限为 100，标识位为 0。

请求示例

curl --location --request GET 'http://{api-host}/v1/api/projects/WlGk4Daj/spaces/VKwkPmqX/user_tags/tag_rfm/users?limit=100&offset=0'
--header 'Authorization: Bearer c2ff9aa1-1824-4cc7-a01f-4094293a6af9'

返回示例

{
    "offset": 0.0,
    "limit": 100.0,
    "totalCount": 100.0,
    "hasNextPage": true,
    "hasPreviousPage": false,
    "values": [
        {
            "gioId": "603542",
            "identifications": {},
            "properties": {}
        },
        {
            "gioId": "605419",
            "identifications": {},
            "properties": {}
        },
        ...
        ]
}

示例 3：搜索群体画像用户列表，并输入用户身份、用户属性、用户标签

场景：根据项目 ID WlGk4Daj 空间 ID VKwkPmqX 搜索 群体画像 tag_rfm 的用户 ID、性别、RFM 标签,单次查询返回数据上限为 100，标识位为 100。

请求示例

curl --location --request GET 'http://{api-host}/v1/api/projects/WlGk4Daj/spaces/VKwkPmqX/user_tags/tag_rfm/users?limit=100&offset=100&properties[]=ids_$basic_userId&properties[]=usr_gender&properties[]=tag_rfm'
--header 'Authorization: Bearer c2ff9aa1-1824-4cc7-a01f-4094293a6af9'

返回示例

{
    "offset": 100.0,
    "limit": 100.0,
    "totalCount": 100.0,
    "hasNextPage": true,
    "hasPreviousPage": true,
    "values": [
        {
            "gioId": "603542",
            "identifications": {
                "id_$basic_userId": ["C001"]
                },
            "properties": {
                "usr_gender":"男",
                "tag_rfm": null
            }
        },
        {
            "gioId": "605419",
            "identifications": {
                "id_$basic_userId": ["C004"]
                },
            "properties": {
                "usr_gender": null,
                "tag_rfm": "低"
            }
        },
        ...
        ]
}