Einführung in die Google Drive Activity API

Die Google 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.

Anfragen

Ihre App fordert die Aktivitätsdaten eines Nutzers über die Methode activity.query an. Sie können Aktivitäten entweder für ein bestimmtes Drive-Element oder für alle Inhalte anfordern, die sich in einem Drive-Ordner befinden. 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 im Hilfeartikel Anfragen über die Drive Activity API senden.

Antwort

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

Erklärung zu Drive-Aktivitäten.

Eine DriveActivity-Ressource ist eine Sammlung von Action-Objekten, die jeweils eigenständig wie ein Ereignis sind. 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 Timestamp oder TimeRange.

Eine DriveActivity-Ressource enthält auch zusammenfassende Informationen, z. B. jede Actor und Target aus allen Aktionen, eine einheitliche Timestamp oder TimeRange und entweder den wichtigsten oder repräsentativsten ActionDetail der Action.

Weitere Informationen finden Sie im Artikel zum Datenmodell der Drive Activity API.

Sichtbarkeit des Aktivitätsverlaufs

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

Die Sichtbarkeit basiert auf den für das Objekt festgelegten Berechtigungen. Es gibt verschiedene Szenarien für die Freigabe von Dateien und Ordnern in Drive:

  • Wenn ein Autor ein Dokument freigibt, ist der Aktivitätsverlauf des Dokuments 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 anschließend 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 der Nutzer keinen Aktivitätsverlauf sehen.

Erste Schritte

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