Descripción general de cambios y revisiones

Google Drive mantiene un historial automático de modificaciones, lo que puede ayudar a los usuarios a hacer un seguimiento de los cambios en los archivos y las revisiones de contenido. En el historial de revisiones, los usuarios pueden ver qué ediciones se realizaron y pueden revertir a una versión específica de un archivo con ediciones específicas.

Los siguientes términos son relevantes para los recursos de cambios y revisiones de la API de Google Drive:

Lista de control de acceso (LCA)
Es la lista de todos los recursos de permisos asociados a un archivo, una carpeta o una unidad compartida.
Cambiar
Es una alteración que se realiza en el contenido o los metadatos de un archivo o una unidad compartida.
Registro de cambios del usuario

Es un registro de todos los cambios que un usuario realizó en cada archivo editable de su unidad de Mi unidad, como un documento, una hoja de cálculo o una presentación de Google. En el caso de los miembros de una unidad compartida, el registro de cambios del usuario también incluye entradas sobre la membresía de la unidad compartida, los niveles de acceso del usuario a los elementos de esa unidad y los cambios de nombre de la unidad compartida.

Registro de cambios de la unidad compartida

Es un registro de todos los cambios realizados en una unidad compartida, como las incorporaciones o eliminaciones de usuarios, y todos los cambios realizados en los elementos de esa unidad compartida. Los cambios en los elementos de una unidad compartida aparecen en el registro de cambios del usuario y en el registro de cambios de la unidad compartida.

Entrada del registro de cambios

Es un registro de un cambio realizado en el contenido o los metadatos de un archivo o una unidad compartida. Una entrada del registro de cambios indica el usuario que realizó el cambio, la marca de tiempo y un ID. Solo puede haber una entrada por archivo o unidad compartida en el registro de cambios a la vez. Cada vez que cambia ese archivo o unidad compartida, se crea un ID nuevo para esa entrada, que reemplaza la entrada anterior.

Revisión

Es una versión del archivo que representa un cambio en su contenido (no en los metadatos). Se puede acceder a cada revisión con el recurso revisions de la API de Drive.

Revisión principal

Es la versión más actual de un archivo. Se puede acceder a headRevisionId con el recurso files dentro de la API de Drive. headRevisionId solo está disponible para los archivos blob en Drive.

Revisión de BLOB

Es una versión de un archivo binario no modificable, como una imagen, un video o un PDF. Si la revisión del BLOB es la única revisión del archivo binario, no se puede borrar. Se puede subir un blob nuevo como una revisión nueva, que se convierte en la revisión principal nueva de ese archivo.

Se puede purgar cualquier revisión de archivo de 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.

Para obtener más información sobre cómo configurar las revisiones de blobs como "Conservar para siempre", consulta Cómo especificar las revisiones que se guardarán de la eliminación automática.

Historial de revisión

Es un registro de todas las revisiones de un archivo en orden cronológico. Los cambios en los archivos de Documentos, Hojas de cálculo o Presentaciones generan una nueva revisión. Cada vez que cambia el contenido, Drive crea una nueva entrada del historial de revisiones para ese archivo. Sin embargo, es posible que estas revisiones de archivos del editor se combinen, por lo que la respuesta de la API podría no mostrar todos los cambios realizados en un archivo.