Reports API는 사용자의 Google Workspace 활동 정보에 액세스하는 데 사용할 수 있는 RESTful API입니다. Reports API는 Admin SDK API의 일부입니다.
Reports API는 두 가지 유형의 보고서를 제공합니다.
- 활동 보고서: Google 드라이브 또는 관리 콘솔과 같은 특정 애플리케이션이나 서비스의 이벤트를 보고합니다.
- 사용량 보고서: 사용자로 인해 작업공간 이벤트가 나열됩니다.
- 고객 사용량 보고서에는 도메인 내 모든 사용자의 이벤트가 나열됩니다.
- 사용자 사용 보고서에는 이벤트가 사용자별로 나열됩니다.
다음은 보고서 API에서 일반적으로 사용되는 용어 목록입니다.
- 활동 보고서
활동 보고서에는 특정 Google Workspace 애플리케이션 또는 서비스의 활동에 관한 정보가 나열됩니다. 활동 보고서에는 날짜, 시간, 사용자, 활동 유형이 포함됩니다. API 참조에서 활동 보고서의 전체 목록과 보고서에 포함되는 정보를 확인할 수 있습니다. 다음은 애플리케이션 또는 서비스별로 나열된 몇 가지 활동 보고서의 예입니다.
- 관리자 활동 보고서는 관리자가 관리 콘솔을 사용하여 수행한 활동을 보여줍니다. 예를 들어 관리자가 관리 콘솔을 사용하여 사용자 이름을 변경한 모든 횟수의 목록을 가져올 수 있습니다.
- Google Drive 활동 보고서에는 도메인 사용자가 Drive 문서를 수정하고 보는 방식이 나열됩니다. 예를 들어 Drive에서의 특정 사용자 활동 목록을 가져올 수 있습니다.
- 로그인 활동 보고서는 계정 사용자가 자신의 계정에 로그인하고 로그아웃하는 시점에 대한 정보를 제공합니다. 예를 들어 특정 기간 동안 도메인의 모든 로그인에 대한 보고서를 가져올 수 있습니다.
- 모바일 활동 보고서는 Google 모바일 관리에서 관리하는 휴대기기를 사용한 활동을 보여줍니다. 예를 들어 사용자가 새 기기를 등록할 때 알림을 받을 수 있습니다.
- OAuth 토큰 활동 보고서는 사용자가 타사 웹사이트 및 애플리케이션에서 사용하는 승인 토큰을 제공하거나 취소한 경우 이벤트를 나열합니다. Reports API를 사용하여 사용자의 Google Workspace 데이터에 대한 모든 서드 파티 액세스 권한 목록을 가져올 수 있습니다.
- 사용 보고서
사용 보고서에는 도메인에서 발생한 Google Workspace 이벤트에 대한 정보가 제공됩니다. API를 사용하여 사용자에 대한 특정 정보를 요청할 수 있습니다.
- 고객 사용량 보고서에는 계정의 자세한 애플리케이션 및 서비스 활동이 나열됩니다. 이 사용 정보는 애플리케이션 유형별로 구성되며 해당 애플리케이션과 관련된 정보를 포함합니다.
- 사용자 사용량 보고서에는 계정 사용자의 활동이 표시됩니다. 이 보고서는 특정 사용량 정보로 맞춤설정하고 필터링할 수 있습니다. 이 사용 정보는 애플리케이션 유형별로 구성되며 해당 애플리케이션과 관련된 정보를 포함합니다.
- 항목 사용량 보고서에는 Currents 애플리케이션에서 계정 사용자가 사용하는 항목과 관련된 활동이 나열됩니다.
- 알림
- Report 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 관리자 고객센터를 참조하세요.