Guide to Drive API v2

If you use Google Drive API version 2, most of the content in the Google Drive API Guide v3 pertains to v2 as well. This section contains all of the information that's v2-specific, and different from what's shown in specific pages of the v3 guide. To get full context, each sub-section contains the link to the corresponding guide page.

For a complete list of differences, see Drive API v2 & v3 comparison reference.

Download & publish file revisions

On the Download & publish file revisions page, the following information is specific to v2, and replaces these sections shown for v3:

List & download individual revisions

Once you get a list of a file's revisions, you can download the content of any revision by sending an authorized GET request to its []downloadUrl](/drive/api/reference/rest/v2/revisions) property. Google Drive generates this short-lived URL when you request the revision. Don't rely on it for later use.

You can also export the revision in one of the supported formats by checking the exportLinks property.

Custom file properties

In addition to the information on the Add custom file properties page, the following information is specific to v2:

Properties are accessed using the properties resource.

This is the structure of a typical property that might be used to store a Drive file's database ID on the file.

  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'

For more information about limits, see properties in the reference documentation.

Enable shared drive support

In addition to the information on the Implement shared drive support page, replace this additional field trashedDate for v2.

In Implement shared drive support, the following methods require supportsAllDrives=true when working with shared drives content:

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

The changes.get and changes.list methods have several parameters specific to shared drives. For a list of parameters, see Track changes on a shared drive section.

Upload files

On the Upload file data page, notice this information is specific to v2:

Import to Google Docs types

When you create a file in Google Drive, you can convert some types file into a Google Docs, Google Sheets, or Google Slides document. Include the files.insert convert query parameters and set the (workspace_name) mimeType property of the file. For more information, see Upload file data.

Share files, folders & drives

Notice on the Share files, folders & drives page, in v3 only one field, role, specifies effective roles for user, group, or domain. In v2, you need both role and additionalRoles fields of a permission reflect the effective roles the user, group, or domain have for a given item.

Search query differences for v2

The v2 title field is name in v3. For examples, see Search for files & folders.

The v2 createdDate field is createdTime in v3. For examples, see Search for shared drives.

The v2 modifiedDate field is modifiedTime in v3. The v2 lastViewedByMeDate field is viewedByMeTime in v3. For more details, see Search query terms & operators.