Reports API 개요

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Reports API는 사용자의 Google Workspace 활동에 대한 정보에 액세스하는 데 사용할 수 있는 RESTful API입니다. Reports API는 Google Workspace 관리 콘솔 SDK의 일부입니다.

Reports API는 두 가지 유형의 보고서를 제공합니다.

  • 활동 보고서: Google Drive나 관리 콘솔과 같은 특정 애플리케이션 또는 서비스의 이벤트를 보고합니다.
  • 사용량 보고서: 사용자에 의해 발생한 작업공간 이벤트가 나열됩니다.
    • 고객 사용량 보고서에는 도메인 내 모든 사용자의 이벤트가 나열됩니다.
    • 사용자 사용 보고서에는 사용자별로 정리된 이벤트가 나열됩니다.

다음은 보고서 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 Issue Tracker, Google Workspace 개발자 블로그, Google Workspace 관리자 고객센터를 참고하세요.