Die Reports API ist eine REST 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, die Ereignisse für eine bestimmte Anwendung oder einen bestimmten Dienst wie Google Drive oder die Admin-Konsole melden.
- Nutzungsberichte: Darin sind Arbeitsbereichsereignisse aufgeführt, die von Nutzern verursacht wurden.
- In Kundennutzungsberichten sind Ereignisse für alle Nutzer in Ihrer Domain aufgeführt.
- In Nutzungsberichten für Nutzer werden Ereignisse nach Nutzer sortiert aufgeführt.
Die folgende Liste enthält gängige Begriffe, die in der Reports API verwendet werden:
- Aktivitätsberichte
Aktivitätsberichte enthalten Informationen zu Aktivitäten in einer bestimmten Google Workspace-Anwendung oder einem bestimmten Google Workspace-Dienst. Aktivitätsberichte enthalten das Datum, die Uhrzeit, den Nutzer und die Art der Aktivität. Die API-Referenz enthält eine vollständige Liste der Aktivitätsberichte und der darin enthaltenen Informationen. Hier einige Beispiele für Aktivitätsberichte, sortiert nach Anwendung oder Dienst:
- Berichte zur Administratoraktivität enthalten Aktivitäten, die von Administratoren über die Admin-Konsole ausgeführt wurden. Sie können beispielsweise eine Liste aller Fälle abrufen, in denen Administratoren den Namen eines Nutzers über die Admin-Konsole geändert haben.
- Google Drive-Aktivitätsberichte enthalten Informationen dazu, wie Nutzer in Ihrer Domain ihre Drive-Dokumente bearbeiten und aufrufen. Sie können beispielsweise eine Liste der Aktivitäten eines bestimmten Nutzers auf Google Drive abrufen.
- Berichte zur Anmeldeaktivität enthalten Informationen dazu, wann sich die Nutzer in Ihrem Konto an- und abmelden. Sie können beispielsweise einen Bericht zu allen Anmeldungen für Ihre Domain über einen bestimmten Zeitraum abrufen.
- Berichte zu mobilen Aktivitäten enthalten Aktivitäten auf Mobilgeräten, die über die Google-Mobilgeräteverwaltung verwaltet werden. Beispielsweise können Sie sich benachrichtigen lassen, wenn Nutzer ein neues Gerät registrieren.
- In Berichten zu OAuth-Token-Aktivitäten werden Ereignisse aufgeführt, wenn Nutzer Autorisierungs-Tokens von Websites und Anwendungen von Drittanbietern erteilt oder widerrufen haben. Mit der Reports API können Sie eine Liste aller Drittanbieterzugriffe auf die Google Workspace-Daten eines Nutzers abrufen.
- Nutzungsberichte
Nutzungsberichte liefern Informationen zu Google Workspace-Ereignissen in Ihrer Domain. Mit der API können Sie bestimmte Informationen zu Nutzern anfordern.
- In Berichten zur Kundennutzung finden Sie detaillierte Anwendungs- und Dienstaktivitäten in Ihrem Konto. Diese Nutzungsinformationen sind nach Anwendungstyp organisiert und enthalten Informationen, die für diese Anwendung spezifisch sind.
- Berichte zur Nutzernutzung enthalten Aktivitäten der Nutzer Ihres Kontos. Diese Berichte können angepasst und nach bestimmten Nutzungsinformationen gefiltert werden. Diese Nutzungsinformationen sind nach Anwendungstyp geordnet und enthalten spezifische Informationen für diese Anwendung.
- Berichte zur Nutzung von Entitäten enthalten Aktivitäten zu Entitäten, die von Nutzern Ihres Kontos in der Currents App verwendet werden.
- Benachrichtigungen
- Die Reports API bietet Benachrichtigungen, mit denen Sie Ereignisse wie Änderungen an Ressourcen beobachten können. Wenn Sie eine Ressource beobachten und sich diese Ressource ändert, erhalten Sie über die Reports API eine Benachrichtigung. Weitere Informationen zum Einrichten und Empfangen von Benachrichtigungen aus der Reports API finden Sie unter Push-Benachrichtigungen empfangen.
Nächste Schritte
Mithilfe eines Schnellstarts können Sie mehr über die Reports API erfahren. Sie wird in der linken Navigationsleiste nach Programmiersprache aufgeführt. In diesem Abschnitt finden Sie allgemeine Informationen zur Einrichtung Ihres Kontos.
Wenn Sie die Reports API verwenden möchten, müssen Sie Ihr Konto entsprechend einrichten und Administrator werden. Außerdem erstellen Sie ein Projekt und registrieren es über die Google API Console. Anschließend aktivieren Sie den Reports API-Dienst.
Im Abschnitt Autorisierung wird beschrieben, wie Sie OAuth 2.0-Zugriffstokens zum Abrufen von Nutzerdaten aus Google Workspace-Anwendungen und -Diensten verwenden.
Details zu einem bestimmten Ressourcentyp oder einer Methode finden Sie in der API-Referenz.
Weitere Informationen finden Sie in der Problemverfolgung der Admin SDK API, im Google Workspace Developers-Blog und in der Google Workspace Admin-Hilfe.