Exportar lista de segmentos
get
/segments/list
Utilice este punto final para exportar una lista de segmentos, cada uno de los cuales incluirá su nombre, identificador de API de segmento y si tiene activado el seguimiento analítico.
Los segmentos se devuelven en grupos de 100 ordenados por hora de creación (de más antiguo a más reciente por defecto). No se incluyen los segmentos archivados.
Requisitos previos
Para utilizar este punto final, necesitarás una clave de API con el permiso segments.list.
Límite de velocidad
Aplicamos el límite de velocidad predeterminado de Braze de 250 000 solicitudes por hora a este punto final, como se documenta en Límites de velocidad de la API.
Parámetros de la solicitud
| Parámetro | Obligatoria | Tipo de datos | Descripción |
|---|---|---|---|
page |
Opcional | Entero | La página de segmentos a devolver, por defecto 0 (devuelve el primer conjunto de hasta 100). |
sort_direction |
Opcional | Cadena | - Ordenar la hora de creación de más reciente a más antigua: introduce el valor desc.- Ordenar la hora de creación de más antiguo a más reciente: introduce el valor asc. Si no se incluye sort_direction, el orden predeterminado es del más antiguo al más reciente. |
Ejemplo de solicitud
1
2
curl --location --request GET 'https://rest.iad-01.braze.com/segments/list?page=1&sort_direction=desc' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Respuesta
1
2
3
4
5
6
7
8
9
10
11
12
13
14
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"message": (required, string) the status of the export, returns 'success' when completed without errors,
"segments" : [
{
"id" : (string) the Segment API identifier,
"name" : (string) segment name,
"analytics_tracking_enabled" : (boolean) whether the segment has analytics tracking enabled,
"tags" : (array) the tag names associated with the segment formatted as strings
},
...
]
}
tip:
Para obtener ayuda con las exportaciones CSV y API, visita Solución de problemas de exportación.
New Stuff!
Editar esta página en GitHub