En esta guía, se explica cómo usar el revisions
recurso para administrar las revisiones de archivos, como obtener una revisión de archivo y
publicar una revisión de Google Workspace. La API de Google Drive también te permite descargar revisiones. Para obtener más detalles sobre la terminología de revisión, consulta Cambios
y descripción general de revisiones.
Para acceder al historial de revisiones, un usuario debe tener la role de owner, organizer, fileOrganizer o writer.
Para especificar los campos que se mostrarán en la respuesta, puedes configurar el fields
parámetro del sistema
con cualquier método del recurso revisions. Si omites el parámetro, el servidor muestra un conjunto predeterminado de campos. Por ejemplo, el método revisions.list solo muestra los campos id, mimeType, kind y modifiedTime. Para mostrar diferentes campos, consulta Muestra campos específicos.
Especifica las revisiones que se guardarán de la eliminación automática
Google Drive borra automáticamente las revisiones anteriores que ya no le interesan al usuario.
Una revisión de archivo blob se puede configurar como "Conservar para siempre", lo que significa que no se puede borrar automáticamente. Se pueden configurar hasta 200 revisiones como "Conservar para siempre", y se incluyen en tu límite de almacenamiento. La revisión principal nunca se borra automáticamente.
Cualquier revisión de archivo blob, que no sea la revisión principal, que no esté designada como "Conservar para siempre" se puede borrar. Por lo general, las revisiones que se pueden borrar se conservan durante 30 días, pero se pueden borrar antes si un archivo tiene 100 revisiones que no están designadas como "Conservar para siempre" y se sube una nueva revisión.
Puedes configurar el campo booleano keepForever del recurso revisions como true para marcar las revisiones que no quieres que borre Drive. Una vez que una revisión de archivo blob se establece en "Conservar para siempre", solo se puede descargar o borrar. Para obtener más información, consulta
Descarga una revisión o Borra una
revisión.
Si usas la versión anterior de la API de Drive v2, usa el pinned campo del
revisions recurso en lugar de
keepForever.
Obtén una revisión de archivo
Para obtener los metadatos o el contenido de una revisión de archivo, usa el get method en el
revisions resource con el fileId y
revisionId path parameters. Si no conoces el ID de revisión, puedes enumerar
todas las revisiones de un archivo con el método list.
El método muestra los metadatos de la revisión como una instancia de un recurso revisions.
Para reconocer el riesgo de descargar software malicioso conocido o cualquier otro
abusivo archivo, configura el
acknowledgeAbuse parámetro de consulta como true. Este campo solo se aplica cuando se configura el parámetro alt=media y el usuario es el propietario del archivo o un organizador de la unidad compartida en la que reside el archivo.
Enumera las revisiones de un archivo
Para enumerar las revisiones de un archivo, usa el list
método en el revisions recurso con el
fileId parámetro de ruta de acceso. El método muestra una lista de revisiones de archivos.
Pasa los siguientes parámetros de consulta para personalizar la paginación de las revisiones o filtrarlas:
pageSize: Es la cantidad máxima de revisiones que se mostrarán por página.pageToken: Es un token de página que se recibe de una llamada de lista anterior. Proporciónalo para recuperar la página siguiente.
Actualiza una revisión de archivo
Para actualizar una revisión en un archivo, usa el
update método en el recurso revisions con los parámetros de ruta de acceso fileId y revisionId.
El método muestra una instancia de un recurso revisions.
Descarga una revisión
Solo puedes descargar las revisiones de contenido de archivos blob marcadas como "Conservar para siempre". Si quieres descargar una revisión, asegúrate de configurarla como "Conservar para siempre" primero. Para obtener más información, consulta Especifica las revisiones que se guardarán de la eliminación automática delete.
Para descargar una revisión de contenido de archivo blob o exportar una revisión de contenido de documento de Google Workspace, consulta Descarga y exporta archivos.
Borra una revisión de archivo
Para borrar de forma permanente una revisión de archivo, usa el
delete método en el recurso revisions con los parámetros de ruta de acceso fileId y revisionId.
Solo puedes borrar revisiones de archivos blob con contenido binario en Drive, como imágenes, videos y archivos PDF. Puedes borrar una revisión de archivo blob cuando está marcada como "Conservar para siempre". No se pueden borrar las revisiones de otros archivos, como Documentos o Hojas de cálculo de Google, ni la última revisión restante del archivo binario.
Publica una revisión
Para publicar una revisión de Documentos, Hojas de cálculo y Presentaciones de Google, set
the published property for that file in the
revisions resource. Esta propiedad no se puede configurar para las revisiones de Google Sites con la API de Drive.
Las revisiones publicadas no reflejan los cambios realizados en un archivo, a menos que se configure la propiedad publishAuto. Si la propiedad se establece en true, se publican automáticamente las revisiones más recientes de un archivo, lo que reemplaza las anteriores.
Presentaciones y Dibujos solo admiten la publicación automática y requieren que la propiedad publishAuto se establezca en true. Para los archivos de Sites, publishAuto siempre es false.
Si el archivo se crea en un dominio de Google Workspace, la propiedad publishedOutsideDomain indica si cualquier persona puede acceder a la revisión o si está restringida a los usuarios del dominio. Para los archivos de Sites, esta propiedad indica si existe un permiso type=anyone. Para
obtener más información, consulta el
type campo en el
permissions recurso.
La publicación automática también se controla con la casilla de verificación "Volver a publicar automáticamente cuando se realicen cambios" en la IU de Documentos y Hojas de cálculo. Para obtener más información, consulta Cómo publicar archivos de Documentos, Hojas de cálculo, Presentaciones y Formularios de Google.