Einführung in die Google Drive Activity API

Dieses Dokument bietet eine Übersicht über die Google Drive Activity API.

Mit der Drive Activity API können Sie nach aktuellen Ereignissen suchen. Sie können einen detaillierten Verlauf aller Aktivitäten abrufen, einschließlich detaillierter Informationen zu jedem Ereignis. Das ist für Aufgaben wie Audits nützlich, da Sie genaue Aktivitäten abrufen können, die die Informationen ActionDetail, Actor und Target enthalten.

Die Drive Activity API besteht aus der Ressource DriveActivity, die Änderungen an Objekten im Google Drive eines Nutzers darstellt, und der Methode activity.query, mit der Sie Informationen zu diesen Änderungen abrufen können.

Anfrage

Ihre App fordert die Aktivitätsdaten eines Nutzers mit der Methode activity.query an. Sie können Aktivitäten entweder für ein bestimmtes Drive-Element oder für alle Elemente in einem Drive-Ordner anfordern. Für eine bestimmte Anfrage können Sie die Antwort mithilfe eines Filters wie Zeitbereich oder Aktionstyp einschränken und die Aktivität in der Antwort konsolidieren lassen. Weitere Informationen finden Sie unter Anfragen in der Google Drive Activity API stellen.

Antwort

Die Antwort enthält eine Liste von Aktivitäten, die den angegebenen Parametern entsprechen. Jede Aktivität wird durch eine DriveActivity-Ressource dargestellt:

Erläuterung der Meldung im Antworttext der Drive Activity API.
Abbildung 1.

Eine DriveActivity-Ressource ist eine Sammlung von Action-Objekten, die jeweils in sich geschlossen sind, wie ein Ereignis. Ein Action enthält ein ActionDetail (z. B. Create oder Edit), ein Actor (z. B. User oder Administrator), ein Target (z. B. DriveItem oder Drive) und entweder ein Timestamp oder ein TimeRange.

Eine DriveActivity-Ressource enthält auch zusammenfassende Informationen wie alle Actor und Target aus allen Aktionen, einen einheitlichen Timestamp oder TimeRange sowie entweder die wichtigsten oder repräsentativsten ActionDetail der Action.

Weitere Informationen finden Sie im Datenmodell der Drive Activity API.

Sichtbarkeit des Aktivitätsverlaufs

Einige Aktivitäten in Drive werden möglicherweise nicht gemeldet, wenn Sie die Drive Activity API verwenden. Ob die API eine bestimmte Änderung an einem Objekt meldet, hängt davon ab, ob die Änderung oder Informationen zur Änderung für den authentifizierten Nutzer in Ihrer App sichtbar sind.

Die Sichtbarkeit basiert auf den für das Objekt festgelegten Berechtigungen. Es gibt verschiedene Szenarien, in denen Dateien und Ordner in Drive freigegeben werden:

  • Wenn ein Autor ein Dokument freigibt, ist der Aktivitätsverlauf des Dokuments sowohl für den Ersteller als auch für die Nutzer sichtbar, für die es freigegeben wurde.

  • Wenn ein Dokument für einen Nutzer freigegeben und dann privat gemacht wurde, kann der Nutzer den gesamten Aktivitätsverlauf aus dem Zeitraum sehen, in dem er Zugriff hatte, aber nicht nach der Einschränkung der Berechtigungen.

  • Wenn ein Dokument nie für einen Nutzer freigegeben wurde, kann dieser Nutzer keinen Aktivitätsverlauf sehen.

  • Damit Sie die Drive Activity API optimal nutzen können, müssen Sie Ihre App zuerst in die Google Drive API einbinden.
  • Informationen zur Entwicklung mit Google Workspace APIs, einschließlich des Erstellens eines Projekts oder der Verarbeitung von Authentifizierung und Autorisierung, finden Sie unter Entwicklung mit Google Workspace.
  • Weitere Informationen zu Aktivitäten finden Sie in der API-Referenz.