获取用户分群的下载链接

URL

https://www.growingio.com/v3/exporter/projects/{project_uid}/segmentations/{segmentation_id}/users

请求类型

GET

结果返回方式

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

请求头参数

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

参数说明与示例

请求参数
响应参数
请求示例
响应示例
请求参数

路径参数

类型

是否必传

说明

segmentation_id

string

用户分群ID,可使用获取分群列表API获取。

project_uid

string

项目UID。

查询参数

类型

是否必传

说明

expire

integer

下载链接失效时间,单位为分钟。最长时间为7天。

默认值:5

备注:若请求已返回了链接结果,则在链接失效期内,再重新传入expire字段不会更新链接的失效时间。

parameters

string

通过用户变量(登录用户变量和访问用户变量)对分群进行二次筛选,此处传变量字段,不传时不进行二次筛选。

变量获取有两种途径:

  1. 在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": ""
}

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

数据处理建议

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