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:
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.