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 los usuarios
Es un registro de todos los cambios que un usuario realizó en cada archivo editable de su unidad de Google, 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
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 recinto compartido. Una entrada del 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 ese archivo o unidad compartida, se crea un ID nuevo para esa entrada y se reemplaza la 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
Es la versión más reciente de un archivo.
Revisión de BLOB

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

Las revisiones de los objetos blob se pueden establecer en "Keep Forever", lo que significa que la revisión no se puede borrar automáticamente. Se pueden establecer hasta 200 revisiones como "Conservar para siempre". La revisión principal nunca se borra automáticamente.

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