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.
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. Bei einer bestimmten Anfrage können Sie die Antwort durch Einschränkungen wie Zeitraum oder Aktionstyp begrenzen und die Aktivität in der Antwort konsolidieren lassen. 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. Jede Aktivität wird durch eine DriveActivity-Ressource dargestellt:
Eine DriveActivity-Ressource ist eine Sammlung von Action-Objekten, die jeweils in sich abgeschlossen sind wie ein Ereignis. 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 einen TimeRange.
Eine DriveActivity-Ressource enthält auch zusammenfassende Informationen wie alle Actor und Target aus allen Aktionen, eine einheitliche Timestamp oder TimeRange sowie entweder die wichtigsten oder repräsentativsten ActionDetail der Action.
Weitere Informationen finden Sie im Datenmodell der Drive Activity API.
Sichtbarkeit des Aktivitätsverlaufs
Bei Verwendung dieser API 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 zur Änderung für den authentifizierten Nutzer in Ihrer Anwendung 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 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 auf „Privat“ gesetzt 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 dieser Nutzer keinen Aktivitätsverlauf sehen.
Jetzt starten
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, müssen Sie zuerst ein Projekt erstellen und Anfragen autorisieren. Oder Sie lesen direkt in der API-Referenz mehr über Aktivitäten.