Der Drive-Aktivitätsbericht enthält Informationen zu den Aktivitäten Ihrer Nutzer, wenn sie Dateien in Google Drive in Google Workspace verwalten, ändern und freigeben. Mit dem Bericht zu Drive-Aktivitäten können Sie beispielsweise eine Liste aller neuen Drive-Dokumente abrufen, die von einem bestimmten Nutzer in einem bestimmten Zeitraum erstellt wurden. Anhand dieser Informationen können Sie die Inhaltsverwaltung optimieren und mögliche Datenlecks erkennen. Um einen Bericht abzurufen, verwenden Sie die Anfrage für den Endpunkt des einfachen Berichts mit Berichtsspezifischen Parametern wie der E-Mail-Adresse eines Nutzers oder einer bestimmten Art von Google Drive-Änderung. Berichte können Daten der letzten 180 Tage enthalten.
Der Google Drive-Aktivitätsbericht darf nur in Konten, denen eine Lizenz zugewiesen ist, für rechtmäßige Zwecke verwendet werden.
Informationen zu den Abfragestrings der Anfrage und den Antworteigenschaften finden Sie in der API-Referenz. Informationen zu bestimmten Ereignissen im Zusammenhang mit Google Drive finden Sie unter Drive-Ereignisnamen.
Google Drive-Ereignisse für eine Domain abrufen
Im Bericht zu Drive-Aktivitäten können Sie Informationen zu Ihren Drive-Dokumenten auflisten. Sie können beispielsweise einen Bericht mit den 25 letzten Drive-Ereignissen Ihres Kontos anfordern, die bis zu 180 Tage zurückreichen. Um diesen Bericht abzurufen, müssen Sie wie im Leitfaden zur Autorisierung beschrieben ein Autorisierungstoken abrufen und dann die folgende HTTP-GET-Anfrage senden:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Eine Beispielantwort auf diesen API-Aufruf findest du hier.
Im folgenden Beispiel wird ein Bericht mit allen Drive-Ereignissen der letzten 180 Tage abgerufen, dem maximalen Zeitraum.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Google Drive-Ereignisse nach Nutzer abrufen
Wenn Sie einen Bericht zu den Google Drive-Aktivitäten eines bestimmten Nutzers abrufen möchten, verwenden Sie eine HTTP-GET-Anfrage mit dem Autorisierungstoken, das im Autorisierungsleitfaden beschrieben ist.
Das Feld userKey ist die primäre E-Mail-Adresse des Nutzers im Bericht oder all für alle Nutzer.
Im folgenden Beispiel wird ein Bericht abgerufen, in dem alle Änderungen aufgeführt sind, die vom angegebenen Nutzer vorgenommen wurden. Ein Beispiel für eine API-Antwort findest du unter JSON-Beispielantwort.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
Google Drive-Ereignisse für geteilte Ablagen abrufen
Sie können einen Bericht zu Google Drive-Aktivitäten für ein bestimmtes freigegebenes Laufwerk mit einer HTTP-GET-Anfrage mit dem Autorisierungstoken abrufen, das im Autorisierungsleitfaden beschrieben ist. Geben Sie im Feld userKey die E-Mail-Adresse des Nutzers an, für den der Bericht erstellt werden soll, oder geben Sie all ein, um den Bericht für alle Nutzer zu erstellen.
Im folgenden Beispiel wird ein Bericht mit allen Änderungen für ein bestimmtes freigegebenes Laufwerk abgerufen. Ein Beispiel für eine API-Antwort findest du in der Beispiel-JSON-Antwort.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>
Wenn Sie Ereignisse für eine geteilte Ablage abrufen möchten, filtern Sie mithilfe von doc_type. Im folgenden Beispiel werden Ereignisse abgerufen, die sich auf alle geteilten Ablagen auswirken:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
Wenn Sie Ereignisse für Mitgliedschaftsänderungen abrufen möchten, geben Sie das Ereignis shared_drive_membership_change an. Im folgenden Beispiel werden alle Mitglieder abgerufen, die geteilten Ablagen hinzugefügt wurden:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive
Google Drive-Ereignisse nach Ereignistyp abrufen
Wenn Sie einen Bericht mit allen Instanzen eines bestimmten Ereignistyps abrufen möchten, z. B. zum Erstellen oder Bearbeiten eines Dokuments, verwenden Sie eine HTTP-GET-Anfrage mit dem Autorisierungstoken, das im Leitfaden zur Autorisierung beschrieben ist.
Das Feld userKey ist die primäre E-Mail-Adresse des Nutzers im Bericht oder all für alle Nutzer.
Im folgenden Beispiel wird ein Bericht mit allen Aktivitäten zum Erstellen von Kontodokumenten abgerufen. Ein Beispiel für eine API-Antwort finden Sie in der Beispiel-JSON-Antwort:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
Beispiel für eine JSON-Antwort
Wenn Sie eine HTTP-GET-Anfrage an die API senden, wird bei einer erfolgreichen Antwort der Statuscode HTTP 200 zurückgegeben. Zusammen mit dem Statuscode wird in der Antwort ein Bericht für das Laufwerk zurückgegeben. Diese Berichte sind auch in der Admin-Konsole verfügbar. Weitere Informationen finden Sie in der Google Workspace Admin-Hilfe.
Weitere Informationen zu eventName finden Sie in der Referenz zu Drive-Ereignisnamen. Weitere Informationen zu den Abfragestrings der Anfrage und den Antworteigenschaften finden Sie in der API-Referenz.
{
"kind": "reports#auditActivities",
"nextPageToken": "next page's token",
"items": [
{
"kind": "audit#activity",
"id": {
"time": "2014-03-17T15:39:18.460Z",
"uniqQualifier": "report's unique ID",
"applicationName": "drive",
"customerId": "ABC123xyz"
},
"actor": {
"callerType": "USER",
"email": "kim@example.com",
"profileId": "user's unique Google Workspace profile ID",
"key": "consumer key of requestor in an OAuth 2LO request"
},
"ownerDomain": "domain of the source owner",
"ipAddress": "user's IP address",
"events": [
{
"type": "access",
"name": "edit",
"parameters": [
{
"name": "primary_event",
"boolValue": true
},
{
"name": "owner_is_shared_drive",
"boolValue": false
}, {
"name": "doc_id",
"value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
},
{
"name": "doc_title",
"value": "Meeting notes"
},
{
"name": "doc_type",
"value": "document"
},
{
"name": "owner",
"value": "mary@example.com"
}
]
}
]
},
]
}