Der Bericht zur Drive-Aktivität 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 zur Drive-Aktivität können Sie beispielsweise eine Liste aller neuen Drive-Dokumente abrufen, die von einem bestimmten Nutzer über einen bestimmten Zeitraum erstellt wurden. Sie können diese Informationen verwenden, um ein besseres Content-Management und mögliche Datenlecks zu erhalten. Um einen Bericht zu erhalten, verwenden Sie die grundlegende Anfrage für einen Berichtsendpunkt mit berichtsspezifischen Parametern wie der E-Mail-Adresse eines Nutzers oder einer bestimmten Art von Änderung in Google Drive. Berichte können Daten für die letzten 180 Tage enthalten.
Sie müssen die Schritte unter Voraussetzungen für die Reports API ausführen, bevor Sie Berichte über die API abrufen können.
Der Google Drive-Aktivitätsbericht darf nur für rechtmäßige Zwecke in Konten verwendet werden, denen eine Lizenz zugewiesen ist.
Informationen zu den Abfragestrings der Anfrage und den Antwortattributen finden Sie in der API-Referenz. Informationen zu bestimmten Ereignissen in Bezug auf Google Drive finden Sie unter Drive-Ereignisnamen.
Google Drive-Ereignisse für eine Domain abrufen
Im Drive-Aktivitätsbericht finden Sie Informationen zu Ihren Drive-Dokumenten. Sie können z. B. einen Bericht anfordern, in dem die letzten 25 Drive-Ereignisse Ihres Kontos für bis zu 180 Tage aufgelistet sind. Rufen Sie diesen Bericht ab, wie in der Anleitung zur Autorisierung beschrieben, und verwenden Sie dann die folgende HTTP-GET-Anfrage:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Sie können eine Beispielantwort auf diesen API-Aufruf sehen.
Im folgenden Beispiel wird ein Bericht mit allen Drive-Ereignissen der letzten 180 Tage (maximaler Zeitraum) abgerufen.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Google Drive-Ereignisse nach Nutzer abrufen
Zum Abrufen eines Berichts zu Google Drive-Aktivitäten eines bestimmten Nutzers verwenden Sie eine HTTP-GET-Anfrage mit dem im Autorisierungsleitfaden beschriebenen Autorisierungstoken.
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 des angegebenen Nutzers aufgeführt sind. Ein Beispiel für eine API-Antwort finden Sie 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 der Google Drive-Aktivitäten für eine bestimmte geteilte Ablage über eine HTTP-GET-Anfrage mit dem im Autorisierungsleitfaden beschriebenen Autorisierungstoken abrufen. Geben Sie im Feld userKey die E-Mail-Adresse des Nutzers an, für den Sie den Bericht ausführen möchten, oder geben Sie all an, um den Bericht für alle Nutzer auszuführen.
Im folgenden Beispiel wird ein Bericht mit allen Änderungen für eine bestimmte geteilte Ablage abgerufen. Ein Beispiel für eine API-Antwort finden Sie unter JSON-Beispielantwort.
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 nach doc_type. Im folgenden Beispiel werden Ereignisse abgerufen, die alle geteilten Ablagen betreffen:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
Geben Sie das Ereignis shared_drive_membership_change an, um Ereignisse für Mitgliedschaftsänderungen abzurufen. Im folgenden Beispiel werden alle Mitglieder zu geteilten Ablagen abgerufen:
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
Verwenden Sie zum Abrufen eines Berichts mit allen Instanzen eines bestimmten Ereignistyps, z. B. zum Erstellen oder Bearbeiten eines Dokuments, eine HTTP-GET-Anfrage mit dem im Autorisierungsleitfaden beschriebenen Autorisierungstoken.
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 über alle Aktivitäten in der Kontodokumentation abgerufen. Ein Beispiel für eine API-Antwort finden Sie unter JSON-Beispielantwort:
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, gibt eine erfolgreiche Antwort den HTTP-Statuscode 200 zurück. Zusammen mit dem Statuscode gibt die Antwort einen Bericht für Google Drive zurück. Diese Berichte sind auch in der Admin-Konsole verfügbar. Weitere Informationen finden Sie in der Google Workspace-Admin-Hilfe.
Informationen zu eventName finden Sie in der Referenz zu Drive-Ereignisnamen. Weitere Informationen zu den Abfragestrings der Anfrage und den Antwortattributen 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"
}
]
}
]
},
]
}