Omówienie interfejsu Reports API
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Reports API to interfejs REST, którego możesz używać do uzyskiwania informacji o aktywności użytkowników w Google Workspace. Interfejs Reports API jest częścią Admin SDK API.
Interfejs Reports API udostępnia 2 rodzaje raportów:
- Raporty Aktywność, które zawierają zdarzenia dotyczące konkretnej aplikacji lub usługi, np. Dysku Google lub konsoli administracyjnej.
- Raporty użycia, które zawierają listę zdarzeń na koncie Workspace wywołanych przez użytkowników.
- Raporty użytkowania klienta zawierają listę zdarzeń wszystkich użytkowników w Twojej domenie.
- Raporty o użytkownikach User zawierają listę zdarzeń uporządkowanych według użytkownika.
Poniżej znajdziesz listę typowych terminów używanych w interfejsie Reports API:
- Raporty aktywności
Raporty aktywności zawierają informacje o aktywności w konkretnej aplikacji lub usłudze Google Workspace. Raporty aktywności zawierają datę, godzinę, użytkownika i rodzaj aktywności. Przewodnik po interfejsie API zawiera pełną listę raportów o aktywności i informacji, które zawierają.
Oto przykładowe raporty o aktywności według aplikacji lub usługi:
- Raporty dotyczące aktywności administratorów
wyświetlają działania wykonywane przez administratorów w konsoli administracyjnej. Możesz na przykład uzyskać listę wszystkich zdarzeń związanych ze zmianą imienia i nazwiska użytkownika przez administratorów za pomocą konsoli administracyjnej.
- Raporty aktywności na Dysku Google
zawierają informacje o tym, jak użytkownicy w Twojej domenie edytują i wyświetlają dokumenty na Dysku. Możesz na przykład uzyskać listę aktywności konkretnego użytkownika na Dysku.
- Raporty aktywności związanej z logowaniem
zawierają informacje o tym, kiedy użytkownicy Twojego konta logują się i wylogowują ze swoich kont. Możesz na przykład uzyskać raport wszystkich logowań w Twojej domenie w określonym przedziale czasu.
- Raporty o aktywności na urządzeniach mobilnych pokazują aktywność na urządzeniach mobilnych zarządzanych przez Zarządzanie urządzeniami mobilnymi Google.
Możesz na przykład otrzymywać powiadomienia, gdy użytkownicy zarejestrują nowe urządzenie.
- Raporty aktywności tokena OAuth
zawierają listę zdarzeń, w których użytkownicy przyznali lub anulowali tokeny autoryzacji używane
przez witryny i aplikacje innych firm. Za pomocą interfejsu Reports API możesz uzyskać listę wszystkich dostępów innych firm do danych Google Workspace użytkownika.
- Raporty o wykorzystaniu
Raporty użytkowania zawierają informacje o zdarzeniach Google Workspace w Twojej domenie.
Za pomocą interfejsu API możesz prosić o konkretne informacje o użytkownikach.
- Raporty o używaniu przez klientów
zawierają szczegółowe informacje o aktywności związanej z aplikacjami i usługami na Twoim koncie. Informacje o użytkowaniu są uporządkowane według typu aplikacji i zawierają informacje
specyficzne dla danej aplikacji.
- Raporty o użyciu przez użytkowników
zawierają informacje o aktywności użytkowników Twojego konta. Raporty te można dostosowywać i filtrować, aby uzyskać konkretne informacje o użytkowaniu. Te informacje o użytkowaniu są uporządkowane według typu aplikacji i zawierają dane dotyczące konkretnej aplikacji.
- Raporty o użyciu podmiotów
zawierają listę działań związanych z podmiotami używanymi przez użytkowników konta w aplikacji Currents.
- Powiadomienia
- Interfejs Reports API udostępnia powiadomienia, które umożliwiają monitorowanie zdarzeń, takich jak zmiany w zasobach. Gdy oglądasz zasób i zostanie on zmieniony, interfejs Reports API wyśle Ci powiadomienie. Więcej informacji o konfigurowaniu i otrzymywaniu powiadomień z interfejsu Reports API znajdziesz w przewodniku Otrzymywanie powiadomień push.
Dalsze kroki
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]
