보고서 API 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
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에서 알림을 설정하고 수신하는 방법에 대한 자세한 내용은 푸시 알림 수신 가이드를 참고하세요.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Reports API Overview\n\nThe Reports API is a RESTful API you can use to access information about the\nGoogle Workspace activities of your users. The Reports API is part of the Admin SDK API.\n\nThe Reports API provides two types of reports:\n\n- **Activity** reports, which report events for a specific application or service, such as Google Drive or the Admin console.\n- **Usage** reports, which list workspace events caused by users.\n - **Customer** usage reports list events for all users in your domain.\n - **User** usage reports list events organized by user.\n\nFollowing is a list of common terms used in the Reports API:\n\n*Activity reports*\n\n: Activity reports list information for activities in a specific Google Workspace\n application or service. Activity reports include the date, time, user, and type\n of activity. The\n [API reference](/workspace/admin/reports/v1/reference)\n contains a complete list of activity reports and the information they include.\n Here are some example activity reports, listed by application or service:\n\n- [Admin activity reports](/workspace/admin/reports/v1/guides/manage-audit-admin) show activities done by administrators using the Admin console. For example, you could get a list of all the times administrators changed a user's name using the Admin console.\n- [Google Drive activity reports](/workspace/admin/reports/v1/guides/manage-audit-drive) list how your domain's users edit and view their Drive documents. For example, you can get a list of a particular user's activity on Drive.\n- [Login activity reports](/workspace/admin/reports/v1/guides/manage-audit-login) provide information on when your account's users log in and out of their accounts. You can, for example, get a report of all the logins for your domain over a particular time period.\n- [Mobile activity reports](/workspace/admin/reports/v1/guides/manage-audit-mobile) show activities using mobile devices managed by [Google Mobile Management](https://workspace.google.com/products/admin/endpoint/). For example, you can get a notification when users register a new device.\n- [OAuth Token activity reports](/workspace/admin/reports/v1/guides/manage-audit-tokens) list events when your users have given or revoked authorization tokens used by third-party websites and applications. You can use the Reports API to get a list of all third-party access to a user's Google Workspace data.\n\n*Usage reports*\n\n: Usage reports provide information about Google Workspace events in your domain.\n You can use the API to request specific information about users.\n\n- [Customers usage reports](/workspace/admin/reports/v1/guides/manage-usage-customers) list detailed application and service activities in your account. This usage information is organized by application type and contains information specific to that application.\n- [Users usage reports](/workspace/admin/reports/v1/guides/manage-usage-users) show activities by your account's users. These reports can be customized and filtered for specific usage information. This usage information is organized by application type and contains information specific to that application.\n- [Entities usage reports](/workspace/admin/reports/v1/guides/manage-usage-entities) list activities related to entities used by your account's users in the Currents application.\n\n*Notifications*\n: The Reports API provides notifications that let you watch for events, such as\n changes to resources. When you're watching a resource and that resource changes,\n the Reports API sends you a notification. For more information on setting up and\n receiving notifications from the Reports API, see the guide to\n [Receiving Push Notifications](/workspace/admin/reports/v1/guides/push).\n\nNext steps\n----------\n\n- To learn about the Reports API and see it work, use a Quickstart,\n which are listed by programming language on the left navigation bar. You can\n also continue through this section to read general information about setting up\n your account.\n\n- The\n [authorization](/workspace/admin/reports/v1/guides/authorizing)\n section shows you how to use OAuth 2.0 access tokens to obtain user data from\n Google Workspace applications and services.\n\n- To find the details of a specific resource type or method, see the\n [API reference](/workspace/admin/reports/v1/reference).\n\n- For more information, see the\n [Admin SDK API issue tracker](https://issuetracker.google.com/savedsearches/566232),\n the\n [Google Workspace Developers blog](https://cloud.google.com/blog/topics/workspace-developers),\n and the\n [Google Workspace Admin help center](https://support.google.com/a)."]]
