GET/audits/logs/download

감사 데이터 파일을 CSV 형식으로 다운로드한다.

대상 도메인에 대한 최고관리자, 부관리자 권한이 있는 사용자이거나 서비스 계정일 경우에만 이용 가능하다.

감사로그 다운로드는 모든 사용자의 형평성있는 서비스 제공을 위해서 동시 요청(Concurrent Request)을 제한하고 있습니다. 그래서 한 번 다운로드 요청을 한 후 그 응답이 완료된 후에 다음 요청을 해주시기 바랍니다.

주의

  • 다운로드 중에 오류가 발생하면 파일 마지막에 "downloadLogs error" 이후 오류 메시지가 출력된다.
  • 리다이렉트된 파일 다운로드 URL은 일정 기간 경과시 사용할 수 없으므로 최신 다운로드 URL을 사용한다.
  • 2025년 11월부터는 API 권한 기준이 관리자/부관리자에서 Admin 감사 메뉴 접근 가능여부 도메인으로 변경됩니다.

참고
API를 이용한 콘텐츠 다운로드 방법은 파일 업로드/다운로드를 참고한다. service=message로 요청 시 "메시지 이벤트" 를 응답합니다. "메시지 내용" 다운로드가 필요한 경우 메시지 내용 다운로드 API 를 이용해주시기 바랍니다.

Authorization

oauth2

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

Scope

audit.read
audit

HTTP Request

GEThttps://www.worksapis.com/v1.0/audits/logs/download

Query Parameters

ParameterTypeDescription
service string 

로그를 조회할 대상 서비스.
admin, board, bot, drive, calendar, contact, task, form, share, note, received-mail, sent-mail, deleted-mail, message, message-join-exit, call, project, clovanote, aistudio-regist, aistudio-talk, template, mobile-capture, developer-console, delegated-api, auth, file-download, approval, payroll


required
Allowed values : admin, board, bot, drive, calendar, contact, task, form, share, note, received-mail, sent-mail, deleted-mail, message, message-join-exit, call, project, clovanote, aistudio-regist, aistudio-talk, template, mobile-capture, developer-console, delegated-api, auth, file-download, approval, payroll 
startTime string 

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


required
example : 2021-05-01T00:00:00+01:00 
endTime string 

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


required
example : 2021-05-31T23:59:59+01:00 
language string 

다운로드하는 Excel 파일의 표시 언어


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이 포함되어 반환된다.