Die Google Drive Activity API besteht aus den
DriveActivity-Ressource, die
Änderungen darstellt, die an Objekten in Google Drive eines Nutzers vorgenommen wurden, und die
activity.query-Methode, mit der Sie
Informationen zu diesen Änderungen.
Anfrage
Ihre App fordert die Aktivitätsdaten eines Nutzers mithilfe des
activity.query-Methode. Du kannst Aktivitäten anfragen
entweder für ein bestimmtes Drive-Element oder für alle Inhalte in Drive
Ordner. Für eine bestimmte Anfrage können Sie die Antwort einschränken, indem Sie
Einschränkungen, wie Zeitraum oder Aktionstyp, und Sie
können Sie festlegen, dass die Aktivitäten im Bereich Konsolidierung von Aktivitäten
Antwort. 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.
Dabei gilt:
Die Ressource DriveActivity steht für jede Aktivität:
Eine DriveActivity-Ressource ist eine Sammlung von
Action-Objekte, von denen jedes
wie ein Ereignis. Ein Action enthält ein
ActionDetail (z. B. Create)
oder Edit), ein Actor (z. B. User
oder Administrator), ein Target (z. B.
als DriveItem oder Drive), und entweder
Timestamp
oder TimeRange.
Eine DriveActivity-Ressource enthält außerdem
zusammenfassende Informationen, wie z. B. alle
Actor und
Target aus allen Aktionen, ein einheitliches
Timestamp
oder TimeRange und entweder
wichtig oder repräsentativ
ActionDetail von
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 Ob eine Änderung an einem Objekt gemeldet wird, hängt davon ab, oder Informationen darüber für den authentifizierten Nutzer Nutzer in Ihrer Anwendung.
Die Sichtbarkeit basiert auf den für das Objekt festgelegten Berechtigungen. Es gibt mehrere Szenarien, wenn Dateien und Ordner in Google Drive freigegeben werden:
- Wenn ein Autor ein Dokument freigibt: der Aktivitätsverlauf für das Dokument ist nicht nur für den Ersteller, sondern auch für die authentifizierten Nutzer sichtbar. mit wem sie geteilt wurde.
- Wenn ein Dokument für einen Nutzer freigegeben und dann als privat gekennzeichnet wurde, Der Nutzer kann den gesamten Aktivitätsverlauf sehen, solange er Zugriff hatte und die Berechtigungen jetzt erfüllt sind eingeschränkt.
- Wenn ein Dokument nie für einen Nutzer freigegeben wurde, kann dieser Nutzer keine Aktivitäten sehen .
Erste Schritte
Um die Drive Activity API optimal zu nutzen, integrieren Sie Ihre App in die Google Drive API. Wenn Sie die Drive Activity API nutzen möchten, Weitere Informationen zum Erstellen eines Projekts und Anfragen autorisieren. Oder fangen Sie direkt an und lesen Sie über Aktivitäten im API-Referenz