캠페인 목록 내보내기
get
/campaigns/list
이 엔드포인트를 사용하여 캠페인 목록을 내보내며, 각 목록에는 이름, 캠페인 API 식별자, API 캠페인인지 여부 및 캠페인과 연결된 태그가 포함됩니다.
캠페인은 생성 시간별로 정렬된 100개 그룹으로 반환됩니다(기본적으로 가장 오래된 것부터 최신 것까지).
필수 구성 요소
이 엔드포인트를 사용하려면 campaigns.list
권한이 있는 API 키가 필요합니다.
사용량 제한
요청 매개변수
매개변수 | 필수 | 데이터 유형 | 설명 |
---|---|---|---|
page |
선택 사항 | 정수 | 반환할 캠페인 페이지의 기본값은 0입니다(최대 100개 중 첫 번째 세트를 반환). |
include_archived |
선택 사항 | 부울 | 보관된 캠페인을 포함할지 여부는 기본값이 false입니다. |
sort_direction |
선택 사항 | 문자열 | - 생성 시간을 최신에서 오래된 순으로 정렬: desc 값을 전달합니다.- 생성 시간을 가장 오래된 것부터 가장 최근 것 순으로 정렬: asc 값을 전달합니다. sort_direction 이 포함되지 않은 경우 기본 순서는 가장 오래된 것부터 최신 것까지입니다. |
last_edit.time[gt] |
선택 사항 | 시간 | 결과를 필터링하여 지금까지 제공된 시간보다 더 많이 편집된 캠페인만 반환합니다. 형식은 yyyy-MM-DDTHH:mm:ss 입니다. |
요청 예시
1
2
curl --location -g --request GET 'https://rest.iad-01.braze.com/campaigns/list?page=0&include_archived=false&sort_direction=desc&last_edit.time[gt]=2020-06-28T23:59:59-5:00' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
응답
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"message": (required, string) the status of the export, returns 'success' when completed without errors,
"campaigns" : [
{
"id" : (string) the Campaign API identifier,
"last_edited": (ISO 8601 string) the last edited time for the message
"name" : (string) the campaign name,
"is_api_campaign" : (boolean) whether the campaign is an API campaign,
"tags" : (array) the tag names associated with the campaign formatted as strings
},
...
]
}
tip:
CSV 및 API 내보내기에 대한 도움말은 내보내기 문제 해결을 참조하세요.
New Stuff!