Reports API – Übersicht
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Die Reports API ist eine RESTful API, mit der Sie auf Informationen zu den Google Workspace-Aktivitäten Ihrer Nutzer zugreifen können. Die Reports API ist Teil der Admin SDK API.
Die Reports API bietet zwei Arten von Berichten:
- Aktivitätsberichte, in denen Ereignisse für eine bestimmte Anwendung oder einen bestimmten Dienst wie Google Drive oder die Admin-Konsole aufgeführt sind.
- Nutzungsberichte, in denen Arbeitsbereichsereignisse aufgeführt sind, die von Nutzern verursacht wurden.
- In Kunden-Nutzungsberichten werden Ereignisse für alle Nutzer in Ihrer Domain aufgeführt.
- In Nutzerberichten werden Ereignisse nach Nutzer sortiert aufgeführt.
Im Folgenden finden Sie eine Liste mit häufig verwendeten Begriffen in der Reports API:
- Aktivitätsberichte
In Aktivitätsberichten werden Informationen zu Aktivitäten in einer bestimmten Google Workspace-Anwendung oder einem bestimmten Google Workspace-Dienst aufgeführt. Aktivitätsberichte enthalten das Datum, die Uhrzeit, den Nutzer und den Aktivitätstyp. Eine vollständige Liste der Aktivitätsberichte und der darin enthaltenen Informationen finden Sie in der API-Referenz.
Hier sind einige Beispiele für Aktivitätsberichte, sortiert nach Anwendung oder Dienst:
- Berichte zu Administratoraktivitäten enthalten Aktivitäten, die von Administratoren über die Admin-Konsole ausgeführt wurden. So können Sie beispielsweise über die Admin-Konsole eine Liste aller Änderungen des Namens eines Nutzers durch Administratoren abrufen.
- In Google Drive-Aktivitätsberichten wird aufgeführt, wie die Nutzer Ihrer Domain ihre Drive-Dokumente bearbeiten und ansehen. So können Sie beispielsweise eine Liste der Aktivitäten eines bestimmten Nutzers in Drive abrufen.
- Berichte zu Log-in-Aktivitäten enthalten Informationen dazu, wann sich die Nutzer Ihres Kontos in ihren Konten an- und abmelden. Sie können sich beispielsweise einen Bericht mit allen Log-ins für Ihre Domain in einem bestimmten Zeitraum erstellen lassen.
- Berichte zu Mobilgeräteaktivitäten enthalten Aktivitäten auf Mobilgeräten, die von Google Mobile Management verwaltet werden.
Sie können beispielsweise eine Benachrichtigung erhalten, wenn Nutzer ein neues Gerät registrieren.
- In Berichten zu OAuth-Token-Aktivitäten werden Ereignisse aufgeführt, wenn Ihre Nutzer Autorisierungstokens erteilt oder widerrufen haben, die von Websites und Anwendungen von Drittanbietern verwendet werden. Mit der Reports API können Sie eine Liste aller Drittanbieterzugriffe auf die Google Workspace-Daten eines Nutzers abrufen.
- Nutzungsberichte
Nutzungsberichte enthalten Informationen zu Google Workspace-Ereignissen in Ihrer Domain.
Mit der API können Sie bestimmte Informationen zu Nutzern anfordern.
- In Nutzungsberichten für Kunden werden detaillierte Anwendungs- und Dienstaktivitäten in Ihrem Konto aufgeführt. Diese Nutzungsinformationen sind nach Anwendungstyp geordnet und enthalten Informationen, die für die jeweilige Anwendung spezifisch sind.
- Berichte zur Nutzung durch Nutzer enthalten Aktivitäten der Nutzer Ihres Kontos. Diese Berichte können angepasst und nach bestimmten Nutzungsinformationen gefiltert werden. Diese Nutzungsinformationen sind nach Anwendungstyp organisiert und enthalten Informationen, die für die jeweilige Anwendung spezifisch sind.
- In Berichten zur Verwendung von Einheiten werden Aktivitäten im Zusammenhang mit Einheiten aufgeführt, die von den Nutzern Ihres Kontos in der Currents-Anwendung verwendet werden.
- Benachrichtigungen
- Die Reports API bietet Benachrichtigungen, mit denen Sie Ereignisse wie Änderungen an Ressourcen im Blick behalten können. Wenn Sie eine Ressource beobachten und sich diese Ressource ändert, sendet die Reports API Ihnen eine Benachrichtigung. Weitere Informationen zum Einrichten und Empfangen von Benachrichtigungen über die Reports API finden Sie im Leitfaden zum Empfangen von Push-Benachrichtigungen.
Nächste Schritte
Wenn Sie mehr über die Reports API erfahren und sie in Aktion sehen möchten, verwenden Sie eine Kurzanleitung. Diese sind in der linken Navigationsleiste nach Programmiersprache aufgeführt. Sie können auch mit diesem Abschnitt fortfahren, um allgemeine Informationen zur Kontoeinrichtung zu lesen.
Im Abschnitt Autorisierung erfahren Sie, wie Sie OAuth 2.0-Zugriffstokens verwenden, um Nutzerdaten aus Google Workspace-Anwendungen und ‑Diensten abzurufen.
Details zu einem bestimmten Ressourcentyp oder einer bestimmten Methode finden Sie in der API-Referenz.
Weitere Informationen finden Sie im Admin SDK API-Issue-Tracker, im Google Workspace Developers-Blog und in der Google Workspace Admin-Hilfe.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-29 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
