获取用户标签的下载链接

通过用户标签 ID，下载用户列表及对应标签值。

用户标签为灰度功能，如需体验试用，请联系客户经理 。

URL

https://www.growingio.com/v3/exporter/projects/{project_uid}/tags/{tag_id}/users

请求类型

GET

结果返回方式

异步：参考 概述 部分的描述

请求头参数

公共头部请参考公共请求头参数。

参数说明与示例

请求参数

路径参数	类型	是否必传	说明
tag_id	string	是	用户标签ID 详细请参考：概述 tag_id的获取方式
project_uid	string	是	项目UID，详细请参考 获取项目UID

查询参数	类型	是否必传	说明
expire	integer	否	下载链接失效时间，单位为分钟。最长时间为7天。 默认值：5 备注：若请求已返回了链接结果，则在链接失效期内，再重新传入expire字段不会更新链接的失效时间。

响应参数

参数	说明
id	随机的ID字符串。
status	导出状态。 done：导出任务完成，客户可以使用 downloadLinks 中的链接进行文件下载。 doing：导出任务正在运行。 failed：导出任务发生错误。
downloadLinks	文件下载链接。 链接可能随时调整，不应使用链接中的任何内容作为处理程序依据，链接过期时间默认为5分钟。
errorMsg	请求发生错误时，服务器返回的错误信息。 示例： 1、请求参数不合法，{不合法值} 2、过期时间应小于7天 3、下载出错，请您稍后重试

请求示例

https://www.growingio.com/v3/exporter/projects/nxog09md/tags/5rREn4PL/users

响应示例

{
  "id":"随机ID",
  "status": "done",
  "downloadLinks": ["https://gta.growingio.com/buckets/segment-download-jobs/20191226/195ae9eb-4a89-457b-b8ce-fb8ca2539131/20191212-20191225_%E6%B8%A0%E9%81%93%E8%AF%84%E4%BC%B0.csv?sign=R9y9atNVIDqU74q34BX%2FgPJI%2Bo22stsGPWZHJ7Tin%2FE%3D&expires=1577344409140"],
  "errorMsg": ""
}

针对该下载地址，可以直接访问并下载文件。文件地址中包含过期的有效时间。

数据处理建议

数据处理建议请参考导出数据处理建议。