Reports API: Bericht zur Drive-Aktivität

Der Drive-Aktivitätsbericht enthält Informationen zu den Aktivitäten Ihrer Nutzer, wenn diese Dateien in Google Drive in Google Workspace verwalten, ändern und freigeben. Sie können beispielsweise den Drive-Aktivitätsbericht verwenden, um eine Liste aller neuen Drive-Dokumente abzurufen, die von einem bestimmten Nutzer für einen bestimmten Zeitraum erstellt wurden. Anhand dieser Informationen können Sie das Content-Management und mögliche Datenlecks optimieren. Um einen Bericht zu erhalten, verwenden Sie die Anfrage für den grundlegenden Berichtsendpunkt 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.

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 in Konten, denen eine Lizenz zugewiesen ist, nur zu rechtmäßigen Zwecken verwendet werden.

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

Mit dem Drive-Aktivitätsbericht können Sie Informationen zu Ihren Drive-Dokumenten auflisten. Sie können beispielsweise einen Bericht anfordern, in dem die letzten 25 Drive-Ereignisse Ihres Kontos aufgeführt sind, die bis zu 180 Tage umfassen. Um diesen Bericht abzurufen, müssen Sie ein Autorisierungstoken abrufen, wie im Autorisierungsleitfaden beschrieben. Verwenden Sie dann die folgende HTTP-GET-Anfrage:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25

Auf diesen API-Aufruf wird eine Beispielantwort angezeigt.

Im folgenden Beispiel wird ein Bericht aller Drive-Ereignisse 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

Wenn Sie einen Bericht zu den Google Drive-Aktivitäten eines bestimmten Nutzers abrufen möchten, 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 aufgeführt sind, die vom angegebenen Nutzer vorgenommen wurden. Ein Beispiel für eine API-Antwort finden Sie unter 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

Mit einer HTTP-GET-Anfrage mit dem im Autorisierungsleitfaden beschriebenen Autorisierungstoken können Sie einen Bericht zu Google Drive-Aktivitäten für eine bestimmte geteilte Ablage abrufen. Geben Sie im Feld userKey die E-Mail-Adresse des Nutzers an, für den Sie den Bericht erstellen möchten, oder geben Sie all an, um den Bericht für alle Nutzer zu erstellen.

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 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 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 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 zu 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 in der Autorisierungsanleitung beschrieben wird. 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 zur Erstellung der Kontodokumentation abgerufen. Ein Beispiel für eine API-Antwort finden Sie unter Beispiel für eine JSON-Antwort:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create

JSON-Beispielantwort

Wenn Sie eine HTTP-GET-Anfrage an die API senden, wird bei einer erfolgreichen Antwort der HTTP-Statuscode 200 zurückgegeben. Zusammen mit dem Statuscode wird in der Antwort ein Bericht für das Drive zurückgegeben. 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"
      }
      ]
     }
    ]
   },
  ]
 }