Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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.
Anfrage
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 Elemente in einem Drive-Ordner anfordern. Bei einer bestimmten Anfrage können Sie die Antwort durch Einschränkungen wie Zeitraum oder Aktionstyp begrenzen und die Aktivität in der Antwort konsolidieren lassen. 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. Jede Aktivität wird durch eine DriveActivity-Ressource dargestellt:
Eine DriveActivity-Ressource ist eine Sammlung von Action-Objekten, die jeweils in sich abgeschlossen sind wie ein Ereignis. 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 einen TimeRange.
Eine DriveActivity-Ressource enthält auch zusammenfassende Informationen wie alle Actor und Target aus allen Aktionen, eine einheitliche Timestamp oder TimeRange sowie entweder die wichtigsten oder repräsentativsten ActionDetail der Action.
Bei Verwendung dieser API 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 zur Änderung für den authentifizierten Nutzer in Ihrer Anwendung sichtbar sind.
Die Sichtbarkeit basiert auf den für das Objekt festgelegten Berechtigungen. Es gibt mehrere Szenarien, in denen Dateien und Ordner in Drive freigegeben werden:
Wenn ein Autor ein Dokument freigibt, 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 auf „Privat“ gesetzt 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 Nutzer keinen Aktivitätsverlauf sehen.
Jetzt starten
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, müssen Sie zuerst ein Projekt erstellen und Anfragen autorisieren. Oder Sie lesen direkt in der API-Referenz mehr über Aktivitäten.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-04 (UTC)."],[],[],null,["# Introduction to Google Drive Activity API\n\nThe Google Drive Activity API consists of the\n[`DriveActivity`](/workspace/drive/activity/v2/reference/rest/v2/activity/driveactivity) resource, which\nrepresents changes made to objects within a user's Google Drive, and the\n[`activity.query`](/workspace/drive/activity/v2/reference/rest/v2/activity/query) method, which allows you to retrieve\ninformation about those changes.\n\nRequest\n-------\n\nYour app requests a user's activity data using the\n[`activity.query`](/workspace/drive/activity/v2/reference/rest/v2/activity/query) method. You can request activity\neither for a specific Drive item or for everything contained under a Drive\nfolder. For a given request, you can choose to restrict the response by\n[constraints](/workspace/drive/activity/v2/requests#filters) such as time range or action type, and you\ncan choose to have the activity [consolidated](/workspace/drive/activity/v2/requests#consolidation) in the\nresponse. For more information, see [Make requests in the Drive Activity API](/workspace/drive/activity/v2/requests).\n\nResponse\n--------\n\nThe response to a request is a list of activities matching the given parameters,\nwhere a\n[`DriveActivity`](/workspace/drive/activity/v2/reference/rest/v2/activity/driveactivity) resource represents each activity:\n\nA [`DriveActivity`](/workspace/drive/activity/v2/reference/rest/v2/activity/driveactivity) resource is a collection of\n[`Action`](/workspace/drive/activity/v2/reference/rest/v2/activity/action) objects, each of which is\nself-contained like an *event* . An `Action` includes an\n[`ActionDetail`](/workspace/drive/activity/v2/reference/rest/v2/activity/actiondetail) (such as `Create`\nor `Edit`), an [`Actor`](/workspace/drive/activity/v2/reference/rest/v2/activity/actor) (such as `User`\nor `Administrator`), a [`Target`](/workspace/drive/activity/v2/reference/rest/v2/activity/target) (such\nas `DriveItem` or `Drive`), and either a\n[`Timestamp`](/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)\nor [`TimeRange`](/workspace/drive/activity/v2/reference/rest/v2/activity/timerange).\n\nA `DriveActivity` resource also contains\nsummary information, such as every\n`Actor` and\n`Target` from all the actions, a unified\n`Timestamp`\nor `TimeRange`, and either the most\nimportant or representative\n`ActionDetail` of the\n`Action`.\n\nFor more information, see the [Drive Activity API data model](/workspace/drive/activity/v2/datamodel).\n\nActivity history visibility\n---------------------------\n\nSome activity on Drive may not be reported when you use this API. Whether the\nDrive Activity API reports a given change to an object depends on whether\nthe change, or information about the change, is visible to the authenticated\nuser in your application.\n\nVisibility is based on the permissions set for the object. There's several\nscenarios when files and folders are shared in Drive:\n\n- If an author shares a document, the activity history for the document is visible to not only the creator, but also to the authenticated users with whom it was shared.\n- If a document was shared with a user and then made private, the authenticated user can see all activity history while they had access and that the permissions are now restricted.\n- If a document was never shared with a user, the user can't see any activity history.\n\nGet started\n-----------\n\nTo get the most out of the Drive Activity API, integrate your app with the\n[Google Drive API](/workspace/drive/api) first. To get started with the Drive Activity API,\nlearn how to [create a project](/workspace/drive/activity/v2/guides/project) and\n[authorize requests](/workspace/guides/configure-oauth-consent). Or, dive right in and read\nabout activities in the\n[API reference](/workspace/drive/activity/v2/reference/rest/v2/activity)."]]
