Reports API는 사용자의 Google Workspace 활동에 관한 정보에 액세스하는 데 사용할 수 있는 RESTful API입니다. Reports API는 Admin SDK API의 일부입니다.
Reports API는 다음과 같은 두 가지 유형의 보고서를 제공합니다.
- 활동 보고서: Google Drive 또는 관리 콘솔과 같은 특정 애플리케이션 또는 서비스의 이벤트를 보고합니다.
- 사용자가 발생시킨 워크스페이스 이벤트를 나열하는 사용량 보고서
- 고객 사용 보고서에는 도메인의 모든 사용자에 대한 이벤트가 표시됩니다.
- 사용자 사용 보고서에는 사용자별로 정리된 이벤트가 표시됩니다.
다음은 Reports API에서 사용되는 일반적인 용어 목록입니다.
- 활동 보고서
활동 보고서에는 특정 Google Workspace 애플리케이션 또는 서비스의 활동에 관한 정보가 표시됩니다. 활동 보고서에는 날짜, 시간, 사용자, 활동 유형이 포함됩니다. API 참조에는 활동 보고서의 전체 목록과 보고서에 포함된 정보가 나와 있습니다. 다음은 애플리케이션 또는 서비스별로 나열된 활동 보고서의 예입니다.
- 관리자 활동 보고서에는 관리 콘솔을 사용하여 관리자가 수행한 활동이 표시됩니다. 예를 들어 관리 콘솔을 사용하여 관리자가 사용자 이름을 변경한 모든 횟수의 목록을 가져올 수 있습니다.
- Google Drive 활동 보고서에는 도메인 사용자가 Drive 문서를 수정하고 보는 방식이 나와 있습니다. 예를 들어 Drive에서 특정 사용자의 활동 목록을 가져올 수 있습니다.
- 로그인 활동 보고서는 계정의 사용자가 계정에 로그인하고 로그아웃한 시점에 관한 정보를 제공합니다. 예를 들어 특정 기간 동안 도메인의 모든 로그인에 관한 보고서를 가져올 수 있습니다.
- 모바일 활동 보고서에는 Google 모바일 관리에서 관리하는 휴대기기를 사용한 활동이 표시됩니다. 예를 들어 사용자가 새 기기를 등록하면 알림을 받을 수 있습니다.
- OAuth 토큰 활동 보고서에는 사용자가 서드 파티 웹사이트 및 애플리케이션에서 사용하는 승인 토큰을 부여하거나 취소한 이벤트가 표시됩니다. Reports API를 사용하여 사용자의 Google Workspace 데이터에 액세스하는 모든 서드 파티의 목록을 가져올 수 있습니다.
- 사용량 보고서
사용 보고서에는 도메인의 Google Workspace 이벤트에 대한 정보가 제공됩니다. 이 API를 사용하여 사용자에 관한 특정 정보를 요청할 수 있습니다.
- 고객 사용 보고서에는 계정의 세부적인 애플리케이션 및 서비스 활동이 나열됩니다. 이 사용 정보는 애플리케이션 유형별로 구성되며 해당 애플리케이션과 관련된 정보를 포함합니다.
- 사용자 사용 보고서에는 계정의 사용자 활동이 표시됩니다. 이러한 보고서는 특정 사용 정보를 기준으로 맞춤설정하고 필터링할 수 있습니다. 이 사용 정보는 애플리케이션 유형별로 정리되며 해당 애플리케이션에 관한 정보를 포함합니다.
- 항목 사용 보고서에는 계정의 사용자가 Currents 애플리케이션에서 사용하는 항목과 관련된 활동이 표시됩니다.
- 알림
- Reports API는 리소스 변경과 같은 이벤트를 모니터링할 수 있는 알림을 제공합니다. 리소스를 보고 있는데 해당 리소스가 변경되면 Reports API에서 알림을 전송합니다. Reports API에서 알림을 설정하고 수신하는 방법에 관한 자세한 내용은 푸시 알림 수신 가이드를 참고하세요.
다음 단계
Reports API에 관해 알아보고 작동 방식을 확인하려면 왼쪽 탐색 메뉴에 프로그래밍 언어별로 나열된 빠른 시작을 사용하세요. 이 섹션을 계속해서 읽으면 계정 설정에 관한 일반적인 정보를 확인할 수도 있습니다.
승인 섹션에서는 OAuth 2.0 액세스 토큰을 사용하여 Google Workspace 애플리케이션 및 서비스에서 사용자 데이터를 가져오는 방법을 보여줍니다.
특정 리소스 유형이나 메서드에 관한 세부정보를 확인하려면 API 참조를 참고하세요.
자세한 내용은 Admin SDK API Issue Tracker, Google Workspace 개발자 블로그, Google Workspace 관리자 고객센터를 참고하세요.