Einführung in die Google Drive Activity API

Die Google Drive Activity API besteht aus der Ressource DriveActivity, die Änderungen an Objekten in 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 durch Einschränkungen wie Zeitraum oder Aktionstyp einschränken und die Aktivität in der Antwort konsolidieren. Weitere Informationen finden Sie unter Anfragen in der Drive Activity API stellen.

Antwort

Die Antwort auf eine Anfrage ist eine Liste von Aktivitäten, die den angegebenen Parametern entsprechen. Dabei steht eine DriveActivity-Ressource für jede Aktivität:

Erläuterung zu Drive-Aktivitäten

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

Eine DriveActivity-Ressource enthält auch zusammenfassende Informationen, z. B. alle Actor und Target aus allen Aktionen, eine einheitliche Timestamp oder TimeRange und entweder die wichtigste oder repräsentative ActionDetail der Action.

Weitere Informationen finden Sie im Datenmodell der Drive Activity API.

Sichtbarkeit des Aktivitätsverlaufs

Wenn Sie diese API verwenden, werden einige Aktivitäten in Drive möglicherweise nicht erfasst. Ob die Drive Activity 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 Anwendung sichtbar sind.

Die Sichtbarkeit richtet sich nach 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 nicht nur für den Ersteller, sondern auch für die authentifizierten Nutzer sichtbar, für die es freigegeben wurde.
  • Wenn ein Dokument für einen Nutzer freigegeben und dann wieder privat gemacht wurde, kann der authentifizierte Nutzer den gesamten Aktivitätsverlauf sehen, während er Zugriff hatte, und dass die Berechtigungen jetzt eingeschränkt sind.
  • Wenn ein Dokument nie für einen Nutzer freigegeben wurde, kann er keinen Aktivitätsverlauf sehen.

Jetzt starten

Damit Sie die Drive Activity API optimal nutzen können, sollten Sie Ihre App zuerst in die Google Drive API einbinden. Wenn Sie mit der Drive Activity API beginnen möchten, erfahren Sie hier, wie Sie ein Projekt erstellen und Anfragen autorisieren. Sie können sich auch direkt in der API-Referenz über Aktivitäten informieren.