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.

Anfragen

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 in einem Drive-Ordner enthaltenen Elemente anfordern. Für eine bestimmte Anfrage können Sie die Antwort durch Einschränkungen wie den Zeitraum oder den Aktionstyp einschränken und die Aktivität in der Antwort konsolidieren lassen. Weitere Informationen

Antwort

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

Erklärung zu Drive-Aktivitäten.

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

Eine DriveActivity-Ressource enthält auch zusammenfassende Informationen, z. B. alle Actor und Target aus allen Aktionen, ein einheitliches Timestamp oder TimeRange und entweder den wichtigsten oder repräsentativsten 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 gemeldet. Ob die Drive Activity API eine bestimmte Änderung an einem Objekt meldet, hängt davon ab, ob die Änderung oder Informationen über die Änderung für den authentifizierten Nutzer der Anwendung sichtbar sind.

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

  • Wenn ein Autor ein Dokument freigibt, ist der Aktivitätsverlauf des Dokuments nicht nur für den Ersteller sichtbar, sondern auch für die authentifizierten Nutzer, für die es freigegeben wurde.
  • Wenn ein Dokument für einen Nutzer freigegeben und anschließend als privat gekennzeichnet 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 noch nie für einen Nutzer freigegeben wurde, kann der Nutzer keinen Aktivitätsverlauf sehen.

Erste Schritte

Zur optimalen Nutzung der Drive Activity API sollten Sie Ihre App zuerst in die Google Drive API einbinden. Für die ersten Schritte mit der Drive Activity API müssen Sie ein Projekt erstellen und Anfragen autorisieren. Sie können auch direkt loslegen und sich über Aktivitäten in der API-Referenz informieren.