Revisions: get

Gets a specific revision. Try it now or see an example.

Request

HTTP request

GET https://www.googleapis.com/drive/v2/files/fileId/revisions/revisionId

Parameters

Parameter name	Value	Description
Path parameters
`fileId`	`string`	The ID of the file.
`revisionId`	`string`	The ID of the revision.

Authorization

This request requires authorization with at least one of the following scopes:

Scope
`https://www.googleapis.com/auth/drive`
`https://www.googleapis.com/auth/drive.file`
`https://www.googleapis.com/auth/drive.readonly`
`https://www.googleapis.com/auth/drive.metadata.readonly`
`https://www.googleapis.com/auth/drive.appdata`
`https://www.googleapis.com/auth/drive.metadata`
`https://www.googleapis.com/auth/drive.photos.readonly`

Some scopes are restricted and require a security assessment for your app to use them. For more information, see the authentication and authorization page.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a Revisions resource in the response body.

Examples

Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).

Java

Uses the Java client library.

import com.google.api.services.drive.Drive;
import com.google.api.services.drive.model.Revision;

import java.io.IOException;
// ...

public class MyClass {

  // ...

  /**
   * Print information about the specified revision.
   *
   * @param service Drive API service instance.
   * @param fileId ID of the file to print revision for.
   * @param revisionId ID of the revision to print.
   */
  private static void printRevision(Drive service, String fileId,
      String revisionId) {
    try {
      Revision revision = service.revisions().get(
          fileId, revisionId).execute();

      System.out.println("Revision ID: " + revision.getId());
      System.out.println("Modified Date: " + revision.getModifiedDate());
      if (revision.getPinned()) {
        System.out.println("This revision is pinned");
      }
    } catch (IOException e) {
      System.out.println("An error occurred: " + e);
    }
  }

  // ...

}

.NET

Uses the .NET client library.

using Google.Apis.Drive.v2;
using Google.Apis.Drive.v2.Data;

using System.Net;
// ...

public class MyClass {

  // ...

  /// <summary>Print information about the specified revision.</summary>
  /// <param name="service">Drive API service instance.</param>
  /// <param name="fileId">ID of the file to print revision for.</param>
  /// <param name="revisionId">ID of the revision to print.</param>
  public static void PrintRevision(DriveService service, String fileId,
      String revisionId) {
    try {
      Revision revision = service.Revisions.Get(fileId, revisionId).Execute();

      Console.WriteLine("Revision ID: " + revision.Id);
      Console.WriteLine("Modified Date: " + revision.ModifiedDate);
      if (revision.Pinned.HasValue && (bool)revision.Pinned) {
        Console.WriteLine("This revision is pinned");
      }
    } catch (Exception e) {
      Console.WriteLine("An error occurred: " + e.Message);
    }
  }

  // ...

}

PHP

Uses the PHP client library.

/**
 * Print information about the specified revision.
 *
 * @param Google_Service_Drive $service Drive API service instance.
 * @param String $fileId ID of the file to print revision for.
 * @param String $revisionId ID of the revision to print.
 */
function printRevision($service, $fileId, $revisionId) {
  try {
    $revision = $service->revisions->get($fileId, $revisionId);

    print "Revision ID: " . $revision->getId();
    print "Modified Date: " . $revision->getModifiedDate();
    if ($revision->getPinned()) {
      print "This revision is pinned";
    }
  } catch (Exception $e) {
    print "An error occurred: " . $e->getMessage();
  }
}

Python

Uses the Python client library.

from apiclient import errors
# ...

def print_revision(service, file_id, revision_id):
  """Print information about the specified revision.

  Args:
    service: Drive API service instance.
    file_id: ID of the file to print revision for.
    revision_id: ID of the revision to print.
  """
  try:
    revision = service.revisions().get(
        fileId=file_id, revisionId=revision_id).execute()

    print 'Revision ID: %s' % revision['id']
    print 'Modified Date: %s' % revision['modifiedDate']
    if revision.get('pinned'):
      print 'This revision is pinned'
  except errors.HttpError, error:
    print 'An error occurred: %s' % error

JavaScript

Uses the JavaScript client library.

/**
 * Print information about the specified revision.
 *
 * @param {String} fileId ID of the file to print revision for.
 * @param {String} revisionId ID of the revision to print.
 */
function printRevision(fileId, revisionId) {
  var request = gapi.client.drive.revisions.get({
    'fileId': fileId,
    'revisionId': revisionId
  });
  request.execute(function(resp) {
    console.log('Revision ID: ' + resp.id);
    console.log('Modified Date: ' + resp.modifiedDate);
    if (resp.pinned) {
      console.log('This revision is pinned');
    }
  });
}

Go

Uses the Go client library.

import (
  "google.golang.org/drive/v2"
  "fmt"
)

// PrintRevision prints a given revision of a given file
func PrintRevision(d *drive.Service, fileId string, revisionId string) error {
  r, err := d.Revisions.Get(fileId, revisionId).Do()
  if err != nil {
    fmt.Printf("An error occurred: %v\n", err)
    return err
  }
  fmt.Printf("Revision ID: %v", r.Id)
  fmt.Printf("Revision modified Date: %v", r.ModifiedDate)
  if r.Pinned {
    fmt.Printf("Revision is pinned")
  }
  return nil
}

Objective-C

Uses the Objective-C client library.

#import "GTLDrive.h"
// ...

+ (void)printRevisionWithService:(GTLServiceDrive *)service
                          fileId:(NSString *)fileId
                      revisionId:(NSString *)revisionId {
  GTLQueryDrive *query =
    [GTLQueryDrive queryForRevisionsGetWithFileId:fileId
                                       revisionId:revisionId];
  // queryTicket can be used to track the status of the request.
  GTLServiceTicket *queryTicket =
    [service executeQuery:query
        completionHandler:^(GTLServiceTicket *ticket, GTLDriveRevision *revision,
                            NSError *error) {
          if (error == nil) {
            NSLog(@"Revision ID: %@", revision.identifier);
            NSLog(@"Modified Date: %@", revision.modifiedDate.stringValue);
            if ([revision.pinned boolValue]) {
              NSLog(@"This revision is pinned");
            }
          } else {
            NSLog(@"An error occurred: %@", error);
          }
        }];
}

// ...

Try it!

Use the APIs Explorer below to call this method on live data and see the response.