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