Drive API . revisions

Instance Methods

delete(fileId, revisionId)

Removes a revision.

get(fileId, revisionId)

Gets a specific revision.

list(fileId)

Lists a file's revisions.

patch(fileId, revisionId, body)

Updates a revision. This method supports patch semantics.

update(fileId, revisionId, body)

Updates a revision.

Method Details

delete(fileId, revisionId)
Removes a revision.

Args:
  fileId: string, The ID of the file. (required)
  revisionId: string, The ID of the revision. (required)
get(fileId, revisionId)
Gets a specific revision.

Args:
  fileId: string, The ID of the file. (required)
  revisionId: string, The ID of the revision. (required)

Returns:
  An object of the form:

    { # A single revision of a file.
      "mimeType": "A String", # The MIME type of the revision.
      "pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated on files with content stored in Drive.
      "kind": "drive#revision", # This is always drive#revision.
      "publishedLink": "A String", # A link to the published revision.
      "publishedOutsideDomain": True or False, # Whether this revision is published outside the domain.
      "publishAuto": True or False, # Whether subsequent revisions will be automatically republished.
      "published": True or False, # Whether this revision is published. This is only populated for Google Docs.
      "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
      "selfLink": "A String", # A link back to this revision.
      "etag": "A String", # The ETag of the revision.
      "fileSize": "A String", # The size of the revision in bytes. This will only be populated on files with content stored in Drive.
      "exportLinks": { # Links for exporting Google Docs to specific formats.
        "a_key": "A String", # A mapping from export format to URL
      },
      "lastModifyingUserName": "A String", # Name of the last user to modify this revision.
      "originalFilename": "A String", # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
      "id": "A String", # The ID of the revision.
      "md5Checksum": "A String", # An MD5 checksum for the content of this revision. This will only be populated on files with content stored in Drive.
      "modifiedDate": "A String", # Last time this revision was modified (formatted RFC 3339 timestamp).
    }
list(fileId)
Lists a file's revisions.

Args:
  fileId: string, The ID of the file. (required)

Returns:
  An object of the form:

    { # A list of revisions of a file.
    "items": [ # The actual list of revisions.
      { # A single revision of a file.
          "mimeType": "A String", # The MIME type of the revision.
          "pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated on files with content stored in Drive.
          "kind": "drive#revision", # This is always drive#revision.
          "publishedLink": "A String", # A link to the published revision.
          "publishedOutsideDomain": True or False, # Whether this revision is published outside the domain.
          "publishAuto": True or False, # Whether subsequent revisions will be automatically republished.
          "published": True or False, # Whether this revision is published. This is only populated for Google Docs.
          "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
          "selfLink": "A String", # A link back to this revision.
          "etag": "A String", # The ETag of the revision.
          "fileSize": "A String", # The size of the revision in bytes. This will only be populated on files with content stored in Drive.
          "exportLinks": { # Links for exporting Google Docs to specific formats.
            "a_key": "A String", # A mapping from export format to URL
          },
          "lastModifyingUserName": "A String", # Name of the last user to modify this revision.
          "originalFilename": "A String", # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
          "id": "A String", # The ID of the revision.
          "md5Checksum": "A String", # An MD5 checksum for the content of this revision. This will only be populated on files with content stored in Drive.
          "modifiedDate": "A String", # Last time this revision was modified (formatted RFC 3339 timestamp).
        },
    ],
    "kind": "drive#revisionList", # This is always drive#revisionList.
    "etag": "A String", # The ETag of the list.
    "selfLink": "A String", # A link back to this list.
  }
patch(fileId, revisionId, body)
Updates a revision. This method supports patch semantics.

Args:
  fileId: string, The ID for the file. (required)
  revisionId: string, The ID for the revision. (required)
  body: object, The request body. (required)
    The object takes the form of:

{ # A single revision of a file.
    "mimeType": "A String", # The MIME type of the revision.
    "pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated on files with content stored in Drive.
    "kind": "drive#revision", # This is always drive#revision.
    "publishedLink": "A String", # A link to the published revision.
    "publishedOutsideDomain": True or False, # Whether this revision is published outside the domain.
    "publishAuto": True or False, # Whether subsequent revisions will be automatically republished.
    "published": True or False, # Whether this revision is published. This is only populated for Google Docs.
    "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
    "selfLink": "A String", # A link back to this revision.
    "etag": "A String", # The ETag of the revision.
    "fileSize": "A String", # The size of the revision in bytes. This will only be populated on files with content stored in Drive.
    "exportLinks": { # Links for exporting Google Docs to specific formats.
      "a_key": "A String", # A mapping from export format to URL
    },
    "lastModifyingUserName": "A String", # Name of the last user to modify this revision.
    "originalFilename": "A String", # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
    "id": "A String", # The ID of the revision.
    "md5Checksum": "A String", # An MD5 checksum for the content of this revision. This will only be populated on files with content stored in Drive.
    "modifiedDate": "A String", # Last time this revision was modified (formatted RFC 3339 timestamp).
  }


Returns:
  An object of the form:

    { # A single revision of a file.
      "mimeType": "A String", # The MIME type of the revision.
      "pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated on files with content stored in Drive.
      "kind": "drive#revision", # This is always drive#revision.
      "publishedLink": "A String", # A link to the published revision.
      "publishedOutsideDomain": True or False, # Whether this revision is published outside the domain.
      "publishAuto": True or False, # Whether subsequent revisions will be automatically republished.
      "published": True or False, # Whether this revision is published. This is only populated for Google Docs.
      "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
      "selfLink": "A String", # A link back to this revision.
      "etag": "A String", # The ETag of the revision.
      "fileSize": "A String", # The size of the revision in bytes. This will only be populated on files with content stored in Drive.
      "exportLinks": { # Links for exporting Google Docs to specific formats.
        "a_key": "A String", # A mapping from export format to URL
      },
      "lastModifyingUserName": "A String", # Name of the last user to modify this revision.
      "originalFilename": "A String", # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
      "id": "A String", # The ID of the revision.
      "md5Checksum": "A String", # An MD5 checksum for the content of this revision. This will only be populated on files with content stored in Drive.
      "modifiedDate": "A String", # Last time this revision was modified (formatted RFC 3339 timestamp).
    }
update(fileId, revisionId, body)
Updates a revision.

Args:
  fileId: string, The ID for the file. (required)
  revisionId: string, The ID for the revision. (required)
  body: object, The request body. (required)
    The object takes the form of:

{ # A single revision of a file.
    "mimeType": "A String", # The MIME type of the revision.
    "pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated on files with content stored in Drive.
    "kind": "drive#revision", # This is always drive#revision.
    "publishedLink": "A String", # A link to the published revision.
    "publishedOutsideDomain": True or False, # Whether this revision is published outside the domain.
    "publishAuto": True or False, # Whether subsequent revisions will be automatically republished.
    "published": True or False, # Whether this revision is published. This is only populated for Google Docs.
    "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
    "selfLink": "A String", # A link back to this revision.
    "etag": "A String", # The ETag of the revision.
    "fileSize": "A String", # The size of the revision in bytes. This will only be populated on files with content stored in Drive.
    "exportLinks": { # Links for exporting Google Docs to specific formats.
      "a_key": "A String", # A mapping from export format to URL
    },
    "lastModifyingUserName": "A String", # Name of the last user to modify this revision.
    "originalFilename": "A String", # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
    "id": "A String", # The ID of the revision.
    "md5Checksum": "A String", # An MD5 checksum for the content of this revision. This will only be populated on files with content stored in Drive.
    "modifiedDate": "A String", # Last time this revision was modified (formatted RFC 3339 timestamp).
  }


Returns:
  An object of the form:

    { # A single revision of a file.
      "mimeType": "A String", # The MIME type of the revision.
      "pinned": True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated on files with content stored in Drive.
      "kind": "drive#revision", # This is always drive#revision.
      "publishedLink": "A String", # A link to the published revision.
      "publishedOutsideDomain": True or False, # Whether this revision is published outside the domain.
      "publishAuto": True or False, # Whether subsequent revisions will be automatically republished.
      "published": True or False, # Whether this revision is published. This is only populated for Google Docs.
      "downloadUrl": "A String", # Short term download URL for the file. This will only be populated on files with content stored in Drive.
      "selfLink": "A String", # A link back to this revision.
      "etag": "A String", # The ETag of the revision.
      "fileSize": "A String", # The size of the revision in bytes. This will only be populated on files with content stored in Drive.
      "exportLinks": { # Links for exporting Google Docs to specific formats.
        "a_key": "A String", # A mapping from export format to URL
      },
      "lastModifyingUserName": "A String", # Name of the last user to modify this revision.
      "originalFilename": "A String", # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
      "id": "A String", # The ID of the revision.
      "md5Checksum": "A String", # An MD5 checksum for the content of this revision. This will only be populated on files with content stored in Drive.
      "modifiedDate": "A String", # Last time this revision was modified (formatted RFC 3339 timestamp).
    }