Die Reports API ist eine RESTful API, mit der Sie auf Informationen Google Workspace-Aktivitäten Ihrer Nutzer. 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 wie Google Drive oder die Admin-Konsole.
- Nutzungsberichte, in denen Workspace-Ereignisse aufgelistet sind, die von Nutzern verursacht wurden.
- Kunden-Nutzungsberichte führen Ereignisse für alle Nutzer in Ihrer Domain auf.
- In Nutzungsberichten für Nutzer sind nach Nutzer geordnete Ereignisse aufgeführt.
Im Folgenden finden Sie eine Liste häufig verwendeter Begriffe, die in der Reports API verwendet werden:
- Aktivitätsberichte
In Aktivitätsberichte werden Informationen zu Aktivitäten in einem bestimmten Google Workspace-Konto aufgelistet Anwendung oder Dienst. Aktivitätsberichte enthalten Datum, Uhrzeit, Nutzer und Typ von Aktivitäten. Die API-Referenz enthält eine vollständige Liste der Aktivitätsberichte und die darin enthaltenen Informationen. Hier sind einige Beispiele für Aktivitätsberichte, die nach Anwendung oder Dienst aufgelistet sind:
- Berichte zu Administratoraktivitäten Aktivitäten anzeigen, die von Administratoren über die Admin-Konsole ausgeführt wurden. Beispiel: Sie könnten eine Liste aller Fälle erhalten, in denen Administratoren den Namen eines Nutzers geändert haben. über die Admin-Konsole.
- Google Drive-Aktivitätsberichte Hier erfahren Sie, wie die Nutzer in Ihrer Domain ihre Drive-Dokumente bearbeiten und aufrufen. Für Sie können beispielsweise eine Liste der Aktivitäten eines bestimmten Nutzers in Google Drive abrufen.
- Berichte zur Anmeldeaktivität Informationen darüber enthalten, wann Nutzer in Ihrem Konto Konten. So können Sie z. B. einen Bericht mit allen Anmeldedaten für Ihre Domain über einen bestimmten Zeitraum.
- Berichte zu mobilen Aktivitäten Aktivitäten mit Mobilgeräten anzeigen, die von verwaltet werden Google-Mobilgeräteverwaltung: Beispielsweise können Sie sich benachrichtigen lassen, wenn Nutzer ein neues Gerät registrieren.
- Berichte zu OAuth-Token-Aktivitäten Ereignisse auflisten, wenn Nutzer verwendete Autorisierungstokens vergeben oder widerrufen haben Websites und Anwendungen von Drittanbietern. Mit der Reports API erhalten Sie Eine Liste aller Zugriffe von Drittanbietern auf die Google Workspace-Daten eines Nutzers.
- Nutzungsberichte
Nutzungsberichte enthalten Informationen zu Google Workspace-Ereignissen in Ihrer Domain. Mit der API können Sie bestimmte Informationen über Nutzer anfordern.
- Nutzungsberichte durch Kunden detaillierte Anwendungs- und Dienstaktivitäten in Ihrem Konto auflisten. Diese Nutzung Die Informationen sind nach Anwendungstyp geordnet speziell für diese Anwendung.
- Berichte zur Nutzernutzung um Aktivitäten der Nutzer Ihres Kontos anzuzeigen. Diese Berichte können angepasst und nach bestimmten Nutzungsinformationen gefiltert. Diese Nutzungsinformationen sind nach Anwendungstyp sortiert und enthält für diese Anwendung spezifische Informationen.
- Berichte zur Entitätsnutzung Listen Sie Aktivitäten im Zusammenhang mit Entitäten auf, die von den Nutzern Ihres Kontos verwendet werden. Currents App.
- Benachrichtigungen
- Die Reports API sendet Benachrichtigungen, mit denen Sie Ereignisse wie Änderungen an den Ressourcen. Wenn sich eine Ressource ändert, sendet Ihnen die Reports API eine Benachrichtigung. Weitere Informationen zum Einrichten und Benachrichtigungen von der Reports API erhalten, finden Sie im Leitfaden zur Push-Benachrichtigungen erhalten
Nächste Schritte
In unserer Kurzanleitung erfahren Sie mehr über die Reports API und wie sie funktioniert. die in der linken Navigationsleiste nach Programmiersprache aufgelistet sind. Sie können finden Sie in diesem Abschnitt auch allgemeine Informationen in Ihrem Konto.
Die Autorisierung wird beschrieben, wie Sie mithilfe von OAuth 2.0-Zugriffstokens Nutzerdaten von Google Workspace-Anwendungen und -Dienste
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 die Blog für Google Workspace-Entwickler, und die Google Workspace-Admin-Hilfe.