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 gemeldet werden, z. B. Google Drive oder die Admin-Konsole.
- Nutzungsberichte, in denen Arbeitsbereichsereignisse aufgelistet werden, die von Nutzern verursacht wurden.
- In den Berichten zur Kundennutzung werden Ereignisse für alle Nutzer in Ihrer Domain aufgeführt.
- In den Nutzungsberichten für Nutzer werden Ereignisse nach Nutzer sortiert aufgeführt.
Im Folgenden finden Sie eine Liste gebräuchlicher 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 Art der Aktivität. Die API-Referenz enthält eine vollständige Liste der Aktivitätsberichte und der darin enthaltenen Informationen. Im Folgenden finden Sie einige Beispiele für Aktivitätsberichte, sortiert nach Anwendung oder Dienst:
- Berichte zur Administratoraktivität enthalten Aktivitäten, die Administratoren über die Admin-Konsole ausgeführt haben. Sie können beispielsweise eine Liste aller Zeiten abrufen, in denen Administratoren den Namen eines Nutzers über die Admin-Konsole geändert haben.
- In den Google Drive-Aktivitätsberichten wird aufgeführt, wie die Nutzer Ihrer Domain ihre Drive-Dokumente bearbeiten und aufrufen. Sie können beispielsweise eine Liste der Aktivitäten eines bestimmten Nutzers auf Drive abrufen.
- Berichte zur Anmeldeaktivität enthalten Informationen dazu, wann sich die Nutzer Ihres Kontos in ihrem Konto an- und abmelden. Sie können beispielsweise einen Bericht über alle Anmeldungen für Ihre Domain innerhalb eines bestimmten Zeitraums abrufen.
- Berichte zu mobilen Aktivitäten enthalten Aktivitäten auf Mobilgeräten, die mit der Google-Mobilgeräteverwaltung verwaltet werden. Sie können sich beispielsweise benachrichtigen lassen, wenn Nutzer ein neues Gerät registrieren.
- In Berichten zur OAuth-Token-Aktivität werden Ereignisse aufgeführt, wenn Ihre Nutzer Autorisierungstokens für Websites und Anwendungen von Drittanbietern erteilt oder widerrufen haben. Mit der Reports API können Sie eine Liste aller Zugriffe von Drittanbietern 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 über Nutzer anfordern.
- In den Nutzungsberichten des Kunden werden detaillierte Anwendungs- und Dienstaktivitäten in Ihrem Konto aufgeführt. Diese Nutzungsinformationen sind nach Anwendungstyp organisiert und enthalten für die jeweilige Anwendung spezifische Informationen.
- Nutzungsberichte enthalten Aktivitäten der Nutzer Ihres Kontos. Diese Berichte lassen sich anpassen und nach bestimmten Nutzungsinformationen filtern. Diese Nutzungsinformationen sind nach Anwendungstyp geordnet und enthalten spezifische Informationen für die jeweilige Anwendung.
- In Nutzungsberichten für Entitäten werden Aktivitäten im Zusammenhang mit 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 nach Ereignissen wie Änderungen an Ressourcen Ausschau halten können. Wenn Sie eine Ressource beobachten und diese sich ändert, sendet die Reports API eine Benachrichtigung. Weitere Informationen zum Einrichten und Empfangen von Benachrichtigungen von der Reports API finden Sie in der Anleitung Push-Benachrichtigungen erhalten.
Nächste Schritte
In der Kurzanleitung erfahren Sie mehr über die Reports API und wie sie funktionieren. Sie sind in der linken Navigationsleiste nach Programmiersprache aufgelistet. Sie können auch diesen Abschnitt durchgehen, um allgemeine Informationen zur Einrichtung Ihres Kontos zu lesen.
Im Abschnitt Autorisierung erfahren Sie, wie Sie mit OAuth 2.0-Zugriffstokens Nutzerdaten aus Google Workspace-Anwendungen und -Diensten abrufen.
Die Details zu einem bestimmten Ressourcentyp oder einer 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.