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 revisiones, los usuarios pueden ver qué ediciones se realizaron y pueden volver 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 con un archivo, una carpeta o un disco compartido.
Cambiar
Es una alteración que se realiza 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 un usuario hizo en cada archivo editable de Mi unidad, como Documentos, Hojas de cálculo o Presentaciones 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 de los usuarios 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 en una unidad compartida, como la adición o eliminación de usuarios, y todos los cambios en los elementos de esa unidad compartida. Los cambios en un elemento dentro 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 un disco compartido. Una entrada de registro de cambios indica el usuario que realizó el cambio, la marca de tiempo y un ID. Solo se puede tener una entrada por archivo o unidad compartida en el registro de cambios a la vez. Cada vez que cambia el archivo o la 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 Revision dentro de la API de Drive.
Revisión principal
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 de 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 de ese archivo.

Las revisiones de BLOB se pueden configurar como “Keep Forever”, lo que significa que la revisión no se puede borrar definitivamente de forma automática. Se pueden establecer hasta 200 revisiones como "Conservar para siempre". La revisión principal nunca se borra definitivamente de forma automática.

Se puede purgar cualquier revisión, excepto la revisión principal, que no esté designada como "Keep Forever". Por lo general, las revisiones borrables se conservan durante 30 días, pero se pueden borrar antes si un archivo tiene 100 revisiones que no están designadas 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 si está marcada como "Mantener para siempre".

Historial de revisión

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

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

Próximos pasos