GET/monitoring/message-contents/download

메시지 내용을 CSV 형식의 파일로 다운로드한다.

관리자 권한이나 Service Account 권한이 있으면 사용할 수 있다.

서비스 안정성을 위해 동시 요청(Concurrent Request)을 제한한다. 이전 요청이 완료되기 전에 또 다른 요청을 하면 서버에서 거부할 수 있다.

주의

  • 다운로드 과정에 오류가 발생하면 파일 내용의 마지막에 downloadLogs error와 함께 자세한 오류 메시지를 남긴다.
  • 파일 다운로드 URL은 언제든 변경될 수 있으므로, 매번 API 요청으로 다운로드 URL을 얻어 온다.
  • 2025년 11월부터는 API 권한 기준이 관리자/부관리자에서 Admin 모니터링 메뉴 접근 가능여부 도메인으로 변경됩니다.

참고
API를 이용한 콘텐츠 다운로드 방법은 파일 업로드/다운로드를 참고한다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증을 참고한다.

Scope

monitoring.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/monitoring/message-contents/download

Query Parameters

ParameterTypeDescription
startTime string 

YYYY-MM-DDThh:mm:ssTZD 형식의 조회 시작일.
- 시작일에서 종료일까지 조회 기간은 최대 31일이다.
- 「+」는 「%2B」로 URL 인코딩되어야 한다.


required
example : 2025-05-01T00:00:00%2B09:00 
endTime string 

YYYY-MM-DDThh:mm:ssTZD 형식의 조회 종료일.
- 시작일에서 종료일까지 조회 기간은 최대 31일이다.
- 「+」는 「%2B」로 URL 인코딩되어야 한다.


required
example : 2025-05-31T23:59:59%2B09:00 
language string 

CSV 형식의 파일에서 표시되는 언어


default : en_US
Allowed values : ko_KR, ja_JP, zh_CN, zh_TW, en_US 
botMessageFilterType string 

Bot 메시지의 포함 여부를 결정한다.
• include: 포함 • exclude: 제외 • only: Bot 메시지만


default : include
Allowed values : include, exclude, only 
domainId integer 

도메인 ID
• 기본값: 조회하는 계정의 도메인 ID


example : 10000001
format : int32 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 302

location 헤더에 파일 접근 URL이 포함되어 반환된다.