> For the complete documentation index, see [llms.txt](https://growingio.gitbook.io/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://growingio.gitbook.io/v3/developer-manual/api-reference/statistics-api-v3/definition/get-segmentations.md).

# 获取用户分群的下载链接

## URL <a href="#url" id="url"></a>

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

## 请求类型 <a href="#qing-qiu-lei-xing" id="qing-qiu-lei-xing"></a>

GET

## 结果返回方式 <a href="#qing-qiu-lei-xing" id="qing-qiu-lei-xing"></a>

异步：参考 [概述](/v3/developer-manual/api-reference/statistics-api-v3/overview.md) 部分的描述

## 请求头参数 <a href="#qing-qiu-tou-can-shu" id="qing-qiu-tou-can-shu"></a>

公共头部请参考[公共请求头参数](/v3/developer-manual/api-reference/authenticate.md)。

## 参数说明与示例 <a href="#can-shu-shuo-ming-yu-shi-li" id="can-shu-shuo-ming-yu-shi-li"></a>

{% tabs %}
{% tab title="请求参数" %}

| 路径参数             | 类型     | 是否必传 | 说明                                                                                                 |
| ---------------- | ------ | ---- | -------------------------------------------------------------------------------------------------- |
| segmentation\_id | string | 是    | 用户分群ID，可使用[获取分群列表API](/v3/developer-manual/api-reference/statistics-api/definition/get-segm.md)获取。 |
| project\_uid     | string | 是    | 项目UID，详细请参考 [获取项目UID](/v3/product-manual/projectmange/projectmange/get-uid.md)                     |

| 查询参数 | 类型 | 是否必传 | 说明 |
| ---- | -- | ---- | -- |

| expire | integer | 否 | <p>下载链接失效时间，单位为分钟。最长时间为7天。</p><p>默认值：5</p><p>备注：若请求已返回了链接结果，则在链接失效期内，再重新传入expire字段不会更新链接的失效时间。</p> |
| ------ | ------- | - | -------------------------------------------------------------------------------------------------- |

| parameters   | string | 否 | <p>通过用户变量（登录用户变量和访问用户变量）对分群进行二次筛选，此处传变量字段，不传时不进行二次筛选。</p><p>变量获取有两种途径：</p><ol><li><a href="/v3/developer-manual/api-reference/project-manage/get-loginvar.md">获取登录用户变量API</a></li><li>在GrowingIO平台获取，请参考 <a href="/v3/product-manual/data-center/data-management/user.md">用户变量</a></li></ol><p>传参格式：<strong>多个参数需用英文逗号链接</strong></p><p><strong>示例:</strong> parameters=open\_id,role</p> |
| ------------ | ------ | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| {% endtab %} |        |   |                                                                                                                                                                                                                                                                                                                                                                                           |

{% tab title="响应参数" %}

| 参数 | 说明 |
| -- | -- |

| id | 随机的ID字符串。 |
| -- | --------- |

| status | <p>导出状态。</p><ul><li>done：导出任务完成，客户可以使用 downloadLinks 中的链接进行文件下载。</li><li>doing：导出任务正在运行。</li><li>failed：导出任务发生错误。</li></ul> |
| ------ | --------------------------------------------------------------------------------------------------------------------------- |

| downloadLinks | <p>文件下载链接。</p><p>链接可能随时调整，不应使用链接中的任何内容作为处理程序依据，链接过期时间默认为5分钟。</p> |
| ------------- | ---------------------------------------------------------------- |

| errorMsg     | <p>请求发生错误时，服务器返回的错误信息。</p><p>示例：</p><p>1、请求参数不合法，{不合法值}</p><p>2、过期时间应小于7天</p><p>3、下载出错，请您稍后重试</p> |
| ------------ | ------------------------------------------------------------------------------------------------- |
| {% endtab %} |                                                                                                   |

{% tab title="请求示例" %}

```
https://www.growingio.com/v3/exporter/projects/nxog09md/segmentations/nP2lpkX9/users?expire=5&parameters=user_name,project
```

{% endtab %}

{% tab title="响应示例" %}

```
{
  "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": ""
}
```

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

## 数据处理建议

数据处理建议请参考[导出数据处理建议](/v3/developer-manual/api-reference/originaldata-export-v2/exportsuggest.md)。