The Activity API consists of the
Activity resource, which represents changes made to
objects within a user's Google Drive, and the
method, which allows you to retrieve information about those changes.
Whether the Drive Activity API can see 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.
Activity resource represents a change as an
of which there are two types:
combinedEvent object, and a
singleEvents list contains all of the individual changes that
are required to complete the change initiated by a user. For example, if a user
creates a file in Google Drive, this action may include events related to
changing permissions, edits to the content, or other events as part of the
file-creation process—all of which are captured in the
combinedEvent represents the net change, or end result of
the events in a
singleEvents list by capturing the common set of
fields shared by all items in a
singleEvents or fields that are
otherwise related. This can include file-creation events, or more complex actions
such as when a user moves multiple files in a single operation, or makes multiple
edits to a file within a short span of time.
To get the most out of the Drive Activity API, integrate your app with the Google Drive API first.