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 erfasst werden.
- Nutzungsberichte, in denen Workspace-Ereignisse aufgeführt sind, die von Nutzern verursacht wurden.
- In Nutzernutzungsberichten werden Ereignisse für alle Nutzer in Ihrer Domain aufgeführt.
- In Nutzer-Nutzungsberichten werden Ereignisse nach Nutzer aufgelistet.
Im Folgenden finden Sie eine Liste gängiger 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 Datum, Uhrzeit, Nutzer und Aktivitätstyp. Die API-Referenz enthält eine vollständige Liste der Aktivitätsberichte und der darin enthaltenen Informationen. Hier einige Beispiele für Aktivitätsberichte, aufgelistet 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 eine Liste aller Zeiten abrufen, zu denen Administratoren den Namen eines Nutzers über die Admin-Konsole geändert haben.
- In Google Drive-Aktivitätsberichten sehen Sie, wie Nutzer Ihrer Domain ihre Drive-Dokumente bearbeiten und aufrufen. So können Sie beispielsweise eine Liste der Aktivitäten eines bestimmten Nutzers in Drive abrufen.
- Berichte zu Anmeldeaktivitäten enthalten Informationen dazu, wann sich die Nutzer Ihres Kontos anmelden und abmelden. Sie können sich beispielsweise einen Bericht zu allen Anmeldungen für Ihre Domain in einem bestimmten Zeitraum ansehen.
- In Berichten zu Mobilgeräteaktivitäten werden Aktivitäten auf Mobilgeräten angezeigt, die über die Google Mobile Management verwaltet werden. So können Sie beispielsweise benachrichtigt werden, wenn Nutzer ein neues Gerät registrieren.
- In den Berichten zu OAuth-Token-Aktivitäten werden Ereignisse aufgeführt, bei denen 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.
- Nutzungsbericht
Nutzungsberichte enthalten Informationen zu Google Workspace-Ereignissen in Ihrer Domain. Über die API können Sie bestimmte Informationen zu Nutzern anfordern.
- In den Nutzungsberichten für Kunden werden detaillierte Anwendungs- und Dienstaktivitäten in Ihrem Konto aufgeführt. Diese Nutzungsinformationen sind nach Anwendungstyp organisiert und enthalten spezifische Informationen zu dieser Anwendung.
- In Nutzungsberichten sehen Sie die 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 spezifische Informationen zu dieser Anwendung.
- In Berichten zur Entitätsnutzung werden Aktivitäten zu Entitäten aufgeführt, die von den Nutzern Ihres Kontos in der Currents App verwendet werden.
- Benachrichtigungen
- Die Reports API bietet Benachrichtigungen, mit denen Sie auf Ereignisse wie Änderungen an Ressourcen achten können. Wenn Sie eine Ressource beobachten und sich diese ändert, erhalten Sie eine Benachrichtigung von der Reports API. 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 sehen möchten, wie sie funktioniert, verwenden Sie eine der Schnellanleitungen, die in der linken Navigationsleiste nach Programmiersprache aufgelistet sind. Sie können auch mit diesem Abschnitt fortfahren, um allgemeine Informationen zur Einrichtung Ihres Kontos zu erhalten.
Im Abschnitt Autorisierung erfahren Sie, wie Sie mit OAuth 2.0-Zugriffstokens Nutzerdaten aus Google Workspace-Anwendungen und ‑Diensten abrufen.
Details zu einem bestimmten Ressourcentyp oder einer bestimmten Methode finden Sie in der API-Referenz.
Weitere Informationen finden Sie im Issue Tracker für die Admin SDK API, im Google Workspace Developers-Blog und in der Google Workspace Admin-Hilfe.