Method: revisions.list

Muestra una lista de las revisiones de un archivo. Para obtener más información, consulta Administra revisiones de archivos.

Importante: Es posible que la lista de revisiones que muestra este método esté incompleta para los archivos con un historial de revisiones extenso, incluidos los archivos de Documentos, Hojas de cálculo y Presentaciones de Google que se editan con frecuencia. Es posible que las revisiones anteriores se omitan de la respuesta, lo que significa que la primera revisión que se muestra podría no ser la más antigua. El historial de revisiones visible en la interfaz de usuario del editor de Workspace podría estar más completo que la lista que muestra la API.

Solicitud HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/revisions

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
fileId

string

Es el ID del archivo.

Parámetros de consulta

Parámetros
pageSize

integer

Es la cantidad máxima de revisiones que se mostrarán. El servicio puede mostrar menos que este valor.

Si no se especifica, se mostrarán como máximo 200 revisiones.

El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000.
pageToken

string

Es el token para continuar una solicitud de lista anterior en la página siguiente. Se debe establecer en el valor de "nextPageToken" de la respuesta anterior.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Una lista de revisiones de un archivo.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "revisions": [
    {
      object (Revision)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Campos
revisions[]

object (Revision)

Es la lista de las revisiones. Si se propaga nextPageToken, es posible que esta lista esté incompleta y se deba recuperar una página adicional de resultados.
nextPageToken

string

Es el token de página para la siguiente página de revisiones. Estará ausente si se llegó al final de la lista de revisiones. Si el token se rechaza por algún motivo, se debe descartar y se debe reiniciar la paginación desde la primera página de resultados. Por lo general, el token de página es válido durante varias horas. Sin embargo, si se agregan o quitan elementos nuevos, es posible que los resultados esperados difieran.
kind

string

Identifica qué tipo de recurso es. Valor: la cadena fija "drive#revisionList".

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

Algunos permisos son restringidos y requieren una evaluación de seguridad para que tu app los use. Para obtener más información, consulta la guía de autorización.