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 mithilfe 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. Sie können die Antwort für eine bestimmte Anfrage durch Einschränkungen wie Zeitraum oder Aktionstyp einschränken und festlegen, dass die Aktivität in der Antwort zusammengeführt werden soll. Weitere Informationen finden Sie unter Anfragen an die Drive Activity API senden.
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:
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 außerdem Zusammenfassungsinformationen, 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 auch direkt loslegen und sich in der API-Referenz über Aktivitäten informieren.