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를 알아보고 작동 방식을 확인하려면 왼쪽 탐색 메뉴에 프로그래밍 언어별로 나열된 빠른 시작을 사용하세요. 이 섹션을 진행하여 계정 설정에 관한 일반적인 정보를 읽어볼 수도 있습니다.
Reports API를 사용하려면 기본 요건 단계에 따라 계정을 설정하고 관리자가 됩니다. 또한 Google API 콘솔을 사용하여 프로젝트를 만들고 등록하며 Reports API 서비스를 활성화합니다.
승인 섹션에서는 OAuth 2.0 액세스 토큰을 사용하여 Google Workspace 애플리케이션 및 서비스에서 사용자 데이터를 가져오는 방법을 보여줍니다.
특정 리소스 유형 또는 메서드의 세부정보를 찾으려면 API 참조를 확인하세요.
자세한 내용은 Admin SDK API Issue Tracker, Google Workspace 개발자 블로그, Google Workspace 관리자 고객센터를 참조하세요.