Die Google Drive Activity API besteht aus der Ressource DriveActivity, die Änderungen an Objekten in der Google Drive-Ablage eines Nutzers darstellt, und der Methode activity.query, mit der Sie Informationen zu diesen Änderungen abrufen können.
Anfragen
Die App fordert die Aktivitätsdaten eines Nutzers mit der Methode activity.query an. Sie können Aktivitäten für ein bestimmtes Drive-Element oder für alles in einem Drive-Ordner anfordern. Für eine bestimmte Anfrage können Sie die Antwort durch Einschränkungen wie Zeitbereich oder Aktionstyp einschränken. Außerdem können Sie die Aktivität in der Antwort konsolidieren. Weitere Informationen finden Sie unter Anfragen über 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 Ressource vom Typ DriveActivity für jede Aktivität:
Eine Ressource vom Typ DriveActivity ist eine Sammlung von Action-Objekten, von denen jedes als Ereignis zusammengefasst ist. 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 auch zusammenfassende Informationen, z. B. alle Actor- und Target-Werte aus allen Aktionen, eine einheitliche Timestamp oder TimeRange und entweder die wichtigste oder repräsentativste ActionDetail der Action.
Weitere Informationen finden Sie unter Drive Activity API-Datenmodell.
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 zur Änderung für den authentifizierten Nutzer in Ihrer Anwendung sichtbar sind.
Die Sichtbarkeit basiert auf den Berechtigungen, die für das Objekt festgelegt wurden. Es gibt mehrere Szenarien, in denen Dateien und Ordner in Drive freigegeben werden:
- Wenn ein Autor ein Dokument teilt, 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 als privat gekennzeichnet wurde, kann der authentifizierte Nutzer den gesamten Aktivitätsverlauf aufrufen, 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 Anwendung zuerst in die Google Drive API einbinden. Informationen zum Einstieg in die Drive Activity API finden Sie unter Projekt erstellen und Anfragen autorisieren. Alternativ können Sie sich die Aktivitäten in der API-Referenz direkt ansehen.