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.
Anfragen
Ihre App fordert die Aktivitätsdaten eines Nutzers über die Methode activity.query
an. Sie können Aktivitäten entweder für ein bestimmtes Drive-Element oder für alle Inhalte anfordern, die sich in einem Drive-Ordner befinden. 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 im Hilfeartikel Anfragen über die Drive Activity API senden.
Antwort
Die Antwort auf eine Anfrage ist eine Liste von Aktivitäten, die mit den angegebenen Parametern übereinstimmen, wobei eine DriveActivity
-Ressource für jede Aktivität steht:
Eine DriveActivity
-Ressource ist eine Sammlung von Action
-Objekten, die jeweils eigenständig wie ein Ereignis sind. 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. jede Actor
und Target
aus allen Aktionen, eine einheitliche Timestamp
oder TimeRange
und entweder den wichtigsten oder repräsentativsten ActionDetail
der Action
.
Weitere Informationen finden Sie im Artikel zum Datenmodell der Drive Activity API.
Sichtbarkeit des Aktivitätsverlaufs
Einige Aktivitäten in Drive werden möglicherweise nicht erfasst, wenn Sie diese API verwenden. Ob die Drive Activity API eine bestimmte Änderung für ein 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. Es gibt verschiedene Szenarien für die Freigabe von Dateien und Ordnern in Drive:
- 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 anschließend 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 der Nutzer keinen Aktivitätsverlauf sehen.
Erste Schritte
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, erfahren Sie hier, wie Sie ein Projekt erstellen und Anfragen autorisieren. Sie können auch direkt loslegen und sich über die Aktivitäten in der API-Referenz informieren.