Descripción general de cambios y revisiones

Google Drive mantiene un historial automático de modificaciones, 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 revisión, los usuarios pueden ver qué ediciones se realizaron y revertir a una versión específica de un archivo con ediciones específicas.

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

Lista de control de acceso (LCA)
Es la lista de todos los recursos de permisos asociados con un archivo, una carpeta o una unidad compartida.
Cambiar
Una alteración realizada en el contenido o los metadatos de un archivo o una unidad compartida.
Registro de cambios de usuarios
Un registro de todos los cambios que realizó un usuario en los archivos editables de Mi unidad, como Documentos, Hojas de cálculo o Presentaciones de Google Para 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 de los usuarios a los elementos de esa unidad compartida y los cambios en sus nombres.
Registro de cambios de la unidad compartida
Un registro de todos los cambios en una unidad compartida, como las adiciones o eliminaciones de usuarios y todos los cambios en los elementos de esa unidad compartida Los cambios que se realicen en un elemento de una unidad compartida aparecerán tanto en el registro de cambios del usuario como en el de la unidad compartida.
Entrada de 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 de 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 a la vez en el registro de cambios. Cada vez que cambia ese archivo o unidad compartida, se crea un ID nuevo para esa entrada que reemplaza a la anterior.
Revisión
Es una versión del archivo que representa un cambio en el contenido del archivo (no los metadatos). Se puede acceder a cada revisión mediante el recurso de revisión de la API de Drive.
Revisión de la cabeza
La versión más reciente de un archivo.
Revisión de BLOB

Es una versión de un archivo binario que no se puede modificar, 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 como una revisión nueva, que se convierte en la nueva revisión principal de ese archivo.

Las revisiones de BLOB se pueden configurar como “Keep Forever”, lo que significa que no se puede borrar automáticamente la revisión de forma automática. Puedes configurar hasta 200 revisiones con la opción "Keep Forever". La revisión de encabezado nunca se borra definitivamente de forma automática.

Cualquier revisión, excepto la revisión principal, que no se designe como "Keep Forever", se puede borrar definitivamente. Por lo general, las revisiones que se pueden borrar definitivamente se conservan durante 30 días, pero se pueden borrar de forma definitiva si un archivo tiene 100 revisiones que no se designan como "Keep Forever" y se sube una revisión nueva.

El campo keepForever del recurso Revisions se usa para establecer una revisión en “Keep Forever”. Además, puedes llamar a revisions.delete para borrar una revisión, incluso cuando esté marcada como "Keep Forever".

Historial de revisión

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

Mira este video para aprender a administrar revisiones con la API de Google Drive:

Próximos pasos