Die Google Drive Activity API besteht aus der DriveActivity-Ressource, die Änderungen an Objekten im Google Drive-Konto eines Nutzers darstellt, und der activity.query-Methode, 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 Inhalte 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, wobei eine DriveActivity-Ressource jede Aktivität darstellt:
Eine DriveActivity-Ressource ist eine Sammlung von Action-Objekten, von denen jedes eigenständig wie ein Ereignis ist. 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. 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
Einige Aktivitäten in Drive werden möglicherweise nicht gemeldet, wenn Sie diese API verwenden. 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 in Ihrer Anwendung sichtbar sind.
Die Sichtbarkeit basiert auf den für das Objekt festgelegten Berechtigungen. Wenn Dateien und Ordner in Google Drive freigegeben werden, gibt es verschiedene Szenarien:
- 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 dann 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 nie für einen Nutzer freigegeben wurde, kann dieser keinen Aktivitätsverlauf sehen.
Erste Schritte
Binden Sie Ihre App zuerst in die Google Drive API ein, um die Drive Activity API optimal zu nutzen. Für die ersten Schritte mit der Drive Activity API müssen Sie ein Projekt erstellen und Anfragen autorisieren. Sie können aber auch direkt in der API-Referenz mehr über Aktivitäten erfahren.