Google Drive Activity API Overview

The Activity API consists of the DriveActivity resource, which represents changes made to objects within a user's Google Drive, and the query method, which allows you to retrieve information about those changes.

Request

Your app requests a user's activity data using the query method. You can request activity either for a specific Drive item or for everything contained underneath a Drive folder. For a given request, you can choose to restrict the response by constraints such as time range or type of action, and you can choose to have the activity consolidated in the response. See the Making Requests guide for more information.

Response

The response to a request is a list of activities matching the given parameters, where each activity is represented by a DriveActivity resource:

DriveActivity

A DriveActivity is a collection of Actions, each of which is self-contained like an event, comprising an ActionDetail (such as Create or Edit), an Actor (such as User or Administrator), a Target (such as DriveItem or TeamDrive), and either a Timestamp or TimeRange.

A DriveActivity also contains summary information, such as the collected Actors and Targets from all the actions, a unified Timestamp or TimeRange, and either the most important or representative ActionDetail of the contained Actions.

See the Data Model guide for more information.

Visibility

Some activity on Drive may not be reported when you use this API. Whether the Drive Activity API will report a given change to an object depends on whether the change, or information about the change, is visible to the user authenticated in your application.

This visibility is based on the permissions set for that object. For example, if an author shares a document in Drive, the activity history for that document will be visible to not only the creator, but also to the authenticated users with whom it was shared. And if the document is then made private again, users will see that the permissions were restricted and will see no further activity on the document.

Getting Started

To get the most out of the Drive Activity API, integrate your app with the Google Drive API first. To get started with the Drive Activity API, learn how to create a project and authorize requests. Or, dive right in and read about activities in the API reference.

Send feedback about...

Google Drive Activity API
Need help? Visit our support page.