Comment on page

获取用户分群的下载链接

URL
​https://www.growingio.com/v3/exporter/projects/{project_uid}/segmentations/{segmentation_id}/users​
请求类型
GET
结果返回方式
异步：参考 概述 部分的描述
请求头参数
公共头部请参考公共请求头参数。
参数说明与示例
请求参数
响应参数
请求示例
响应示例
路径参数
类型
是否必传
说明
segmentation_id
string
是
用户分群ID，可使用获取分群列表API获取。
project_uid
string
是
项目UID，详细请参考 获取项目UID​
查询参数
类型
是否必传
说明
expire
integer
否
下载链接失效时间，单位为分钟。最长时间为7天。
默认值：5
备注：若请求已返回了链接结果，则在链接失效期内，再重新传入expire字段不会更新链接的失效时间。
parameters
string
否
通过用户变量（登录用户变量和访问用户变量）对分群进行二次筛选，此处传变量字段，不传时不进行二次筛选。
变量获取有两种途径：
1.​获取登录用户变量API​
2.在GrowingIO平台获取，请参考 用户变量​
传参格式：多个参数需用英文逗号链接
示例: parameters=open_id,role
参数
说明
id
随机的ID字符串。
status
导出状态。
done：导出任务完成，客户可以使用 downloadLinks 中的链接进行文件下载。
doing：导出任务正在运行。
failed：导出任务发生错误。
downloadLinks
文件下载链接。
链接可能随时调整，不应使用链接中的任何内容作为处理程序依据，链接过期时间默认为5分钟。
errorMsg
请求发生错误时，服务器返回的错误信息。
示例：
1、请求参数不合法，{不合法值}
2、过期时间应小于7天
3、下载出错，请您稍后重试
https://www.growingio.com/v3/exporter/projects/nxog09md/segmentations/nP2lpkX9/users?expire=5&parameters=user_name,project
{
  "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": ""
}
针对该下载地址，可以直接访问并下载文件。文件地址中包含过期的有效时间。
数据处理建议
数据处理建议请参考导出数据处理建议。

以前

获取分布分析数据

下一个

获取用户标签的下载链接

最近更新 2yr ago

路径参数	类型	是否必传	说明
segmentation_id	string	是	用户分群ID，可使用获取分群列表API获取。
project_uid	string	是	项目UID，详细请参考获取项目UID