En esta guía, se explica cómo usar el recurso revisions para administrar las revisiones de archivos, como obtener una revisión de un 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 las revisiones, consulta la Descripción general de los cambios y las revisiones.
Para acceder al historial de revisiones, un usuario debe tener el role de owner, organizer, fileOrganizer o writer.
Para especificar los campos que se devolverá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 devolverá un conjunto predeterminado de campos. Por ejemplo, el método revisions.list solo devuelve los campos id, mimeType, kind y modifiedTime. Para devolver diferentes campos, consulta Cómo devolver campos específicos.
Cómo especificar las revisiones que se guardarán de la eliminación automática
Google Drive borra automáticamente las revisiones más antiguas que ya no son de interés para el usuario.
Una revisión de archivo blob se puede establecer como "Conservar para siempre", lo que significa que no se puede purgar automáticamente. Se pueden establecer hasta 200 revisiones como "Conservar para siempre", y estas se incluyen en tu límite de almacenamiento. La revisión principal nunca se borra automáticamente.
Se puede purgar cualquier revisión de archivo BLOB, excepto la revisión principal, que no esté designada como "Conservar para siempre". Por lo general, las versiones que se pueden purgar se conservan durante 30 días, pero se pueden purgar antes si un archivo tiene 100 versiones que no están designadas como "Conservar para siempre" y se sube una versión nueva.
Puedes establecer el campo booleano keepForever del recurso revisions en true para marcar las revisiones que no quieres que Drive borre. Una vez que una revisión de archivo BLOB se establece como "Keep Forever", solo se puede descargar o borrar. Para obtener más información, consulta Cómo descargar una revisión o Cómo borrar una revisión.
Si usas la versión anterior de la API de Drive v2, usa el campo pinned del recurso revisions en lugar de keepForever.
Obtén una revisión de un archivo
Para obtener los metadatos o el contenido de una revisión de archivo, usa el método get en el recurso revisions con los parámetros de ruta de acceso fileId y revisionId. Si no conoces el ID de revisión, puedes listar todas las revisiones de un archivo con el método list.
El método devuelve los metadatos de la revisión como una instancia de un recurso revisions.
Para confirmar que conoces el riesgo de descargar software malicioso conocido o archivos abusivos, establece el parámetro de consulta acknowledgeAbuse en true. Este campo solo se aplica cuando se establece el parámetro alt=media y el usuario es el propietario del archivo o el organizador de la unidad compartida en la que se encuentra el archivo.
Enumera las revisiones de un archivo
Para enumerar las revisiones de un archivo, usa el método list en el recurso revisions con el parámetro de ruta de acceso fileId. El método devuelve una lista de las revisiones del archivo.
Pasa los siguientes parámetros de consulta para personalizar la paginación o filtrar las revisiones:
pageSize: Es la cantidad máxima de revisiones que se mostrarán por página.pageToken: Es un token de página que se recibió de una llamada a lista anterior. Proporciona este token para recuperar la página siguiente.
Actualiza una revisión de archivo
Para actualizar una revisión en un archivo, usa el método update en el recurso revisions con los parámetros de ruta de acceso fileId y revisionId.
El método devuelve una instancia de un recurso revisions.
Descarga una revisión
Solo puedes descargar las revisiones del contenido de los archivos BLOB marcadas como "Conservar para siempre". Si quieres descargar una revisión, primero asegúrate de establecerla como "Conservar para siempre". Para obtener más información, consulta Cómo especificar las revisiones que se deben guardar de la eliminación automática.
Para descargar una revisión de contenido de un archivo blob o exportar una revisión de contenido de un documento de Google Workspace, consulta Descarga y exporta archivos.
Cómo borrar una revisión de un archivo
Para borrar de forma permanente una revisión de archivo, usa el método delete 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 PDFs. Puedes borrar una revisión de un archivo blob cuando se marca como "Conservar para siempre". No se pueden borrar las revisiones de otros archivos, como los de 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, establece la propiedad published para ese archivo en el recurso revisions. Esta propiedad no se puede establecer 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 establezca la propiedad publishAuto. Si la propiedad está configurada como true, se publican automáticamente las revisiones más recientes de un archivo, lo que reemplaza las anteriores.
Las Presentaciones y los Dibujos solo admiten la republicació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. En el caso de los archivos de Sites, esta propiedad indica si existe un permiso de type=anyone. Para obtener más información, consulta el campo type en el recurso permissions.
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.