Im Bericht „Google Drive-Aktivitäten“ finden Sie Informationen zu den Aktivitäten wenn sie Dateien in Google Drive in Google Workspace verwalten, ändern und freigeben. Sie können beispielsweise den Drive-Aktivitätsbericht verwenden, um eine Liste mit aller neuen Drive-Dokumente, die von einem bestimmten Nutzer über Zeitraum festgelegt wird. Anhand dieser Informationen können Sie Einblicke besseres Content-Management und mögliche Datenlecks. Um einen Bericht zu erhalten, verwenden Sie die einfache Berichtsendpunkt-Anfrage mit berichtsspezifischen Parametern wie E-Mail-Adresse des Nutzers oder eine bestimmte Google Drive-Änderung Berichte können Daten für die letzten 180 Tage enthalten.
Der Google Drive-Aktivitätsbericht darf nur für rechtmäßige Zwecke in Konten verwendet werden, die denen eine Lizenz zugewiesen wurde.
Informationen zu den Abfragestrings und den Antworteigenschaften der Anfrage finden Sie in der API-Referenz. Für Informationen zu bestimmten Ereignissen in Bezug auf Google Drive erhalten Sie unter Drive-Ereignisnamen.
Google Drive-Ereignisse für eine Domain abrufen
Mit dem Google Drive-Aktivitätsbericht können Sie Informationen zu Ihren
Drive-Dokumente. Sie können z. B. eine Berichtsauflistung
die 25 letzten Drive-Ereignisse Ihres Kontos, in denen insgesamt bis zu 180
Tage. Um diesen Bericht zu erhalten, fordern Sie ein Autorisierungstoken an, wie in den
Autorisierungsleitfaden und verwenden Sie dann
folgende HTTP-GET-Anfrage:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Sie können sich eine Beispielantwort auf diesen API-Aufruf ansehen.
Im folgenden Beispiel wird ein Bericht für alle Drive-Dateien abgerufen, Ereignisse der letzten 180 Tage, dem maximalen Zeitraum
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Google Drive-Ereignisse nach Nutzer abrufen
Um einen Bericht zu den Google Drive-Aktivitäten eines bestimmten Nutzers abzurufen, verwenden Sie ein
HTTP-GET-Anfrage mit dem im
Leitfaden zur Autorisierung.
Das Feld userKey enthält 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 aufgelistet sind, die von zum angegebenen Nutzer gesendet werden. Ein Beispiel für eine API-Antwort finden Sie in der Beispiel für eine JSON-Antwort
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 eine bestimmte
mit einer HTTP-GET-Anfrage mit dem im
Autorisierungsleitfaden. Geben Sie die
E-Mail-Adresse des Nutzers, für den Sie den Bericht erstellen möchten, im Feld userKey,
oder all angeben, um den Bericht für alle Nutzer zu erstellen.
Im folgenden Beispiel wird ein Bericht mit allen Änderungen für eine bestimmte freigegebene Datei abgerufen Google Drive. Ein Beispiel für eine API-Antwort finden Sie im Beispiel für eine 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 mit doc_type. Die
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 shared_drive_membership_change an, um Ereignisse für Mitgliedschaftsänderungen abzurufen
. Im folgenden Beispiel werden alle zu geteilten Ablagen hinzugefügten Mitglieder 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
Wenn Sie einen Bericht mit allen Instanzen eines bestimmten Ereignistyps abrufen möchten, z. B.
oder beim Bearbeiten eines Dokuments verwenden, verwenden Sie eine HTTP-GET-Anfrage mit der Autorisierung
im Autorisierungsleitfaden beschrieben.
Das Feld userKey enthält die primäre E-Mail-Adresse des Nutzers im Bericht oder
all für alle Nutzer.
Im folgenden Beispiel wird ein Bericht zur gesamten Erstellung von Kontodokumentationen abgerufen Aktivitäten. Ein Beispiel für eine API-Antwort finden Sie im Beispiel für eine 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 ein
HTTP 200-Statuscode. Zusammen mit dem Statuscode gibt die Antwort einen Bericht
für die Ablage. Diese Berichte sind auch in der
Admin-Konsole. Weitere Informationen finden Sie in der
Google Workspace-Admin-Hilfe
Informationen zu eventName finden Sie in der
Drive-Ereignisnamen
Referenz. Weitere Informationen zu den Abfragestrings der Anfrage und den
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"
}
]
}
]
},
]
}