Changes and revisions overview

The Drive API keeps track of all changes made to a file, and calls each change a revision, which is the record of a change that includes the recorded date, time, and user who made the change.

All revisions are tracked in a version history, which is a record of all revisions to a file in chronological order. The version is the actual file that can be reverted back to a previous version. You can use the Drive API to save revisions of a file or query the version history using the Revisions resource. To publish a file revision, see Download and publish file revisions.

Each user and shared drive has a change log that records changes. For shared drives, the change log records only changes to files in that shared drive. For more information about change logs, see Track changes for users and shared drives.

Spaces and corpora

The Drive API organizes files into storage locations called spaces, and collections called corpora.

Spaces

Spaces are specific storage locations that are isolated from each other. All available content in Google Drive will be stored in one of these three defined spaces in Drive: drive, appDataFolder, and photos. Files cannot move between spaces.

  • The default drive space includes all user-visible files created or stored in Google Drive. PDFs, Google Docs, Sheets, and slides, as well as any other content the user uploads is located in the drive space.
  • The appDataFolder space is a separate storage area for per-user application data. Applications typically store configuration files and other data not intended to be directly accessed by users.
  • The default photos space includes all user-visible image files created or stored in Google Drive.

Corpora

Corpora, like spaces, represent different collections of items and are used to direct searches. Unlike spaces, they're not isolated storage. Files within a space may move freely from one corpus to another.

The corpora in the Drive API are:

  • The default corpus includes all files in "My Drive" and "Shared with me"
  • The domain corpus includes all files shared to the user's domain that are searchable.
  • The drive corpus includes all files contained in a single shared drive.
  • The allDrives corpus includes all files in shared drives that the user is a member of and all files in "My Drive" and "Shared with me." Use of the allSharedDrives corpus is discouraged for efficiency reasons. Prefer 'drive' or 'default' for efficiency.

Files can move between corpora as permissions and ownership change.

Send feedback about...

Drive REST API v2
Drive REST API v2
Need help? Visit our support page.