In diesem Dokument finden Sie 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 nützlich für Aufgaben wie Audits, da Sie genaue Aktivitäten abrufen können, die die Informationen ActionDetail, Actor und Target enthalten.
Die Drive Activity API besteht aus der
DriveActivity Ressource, die
Änderungen an Objekten im Google Drive eines Nutzers darstellt, und der
activity.query Methode, mit der Sie
Informationen zu diesen Änderungen abrufen können.
Anfrage
Ihre App fordert mit der Methode activity.query Aktivitätsdaten eines Nutzers 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 mit einem Filter wie einem Zeitraum
oder einem Aktionstyp einschränken und die Aktivitäten in der Antwort zusammenfassen 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. Dabei stellt
eine DriveActivity-Ressource jede
Aktivität dar:
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), einen Actor (z. B. User oder Administrator), ein Target (z. B. DriveItem oder Drive) und entweder einen
Timestamp
oder einen TimeRange.
Eine DriveActivity-Ressource enthält auch zusammenfassende Informationen wie alle
Actor und Target aus allen Aktionen, einen einheitlichen Timestamp oder TimeRange,
und entweder das wichtigste oder repräsentativste 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 dazu für den authentifizierten Nutzer in Ihrer App sichtbar sind.
Die Sichtbarkeit basiert auf den für das Objekt festgelegten Berechtigungen. Es gibt mehrere Szenarien, in denen Dateien und Ordner in Drive freigegeben werden:
Wenn ein Autor ein Dokument freigibt, ist der Aktivitätsverlauf für das Dokument 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 mehr, nachdem die Berechtigungen eingeschränkt wurden.
Wenn ein Dokument nie für einen Nutzer freigegeben wurde, kann der Nutzer keinen Aktivitätsverlauf sehen.
Weitere Informationen
- Um die Drive Activity API optimal zu nutzen, 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.
- Informationen zu Aktivitäten finden Sie in der API-Referenz.