En el caso de las apps de Google Drive que necesitan hacer un seguimiento de los cambios en los elementos de Drive, la colección de cambios proporciona una forma eficiente de detectarlos. La colección funciona proporcionando el estado actual de cada elemento, solo si este cambió desde un momento determinado.
Google Drive mantiene un registro de cambios para cada usuario y unidad compartida. Cada uno tiene su propio registro de cambios en los elementos que le interesan.
Para hacer un seguimiento de los cambios de todos los elementos visibles para un usuario, se deben volver a reproducir el registro de cambios del usuario y los registros de cambios de todos los viajes compartidos de los que el usuario es miembro.
Habilita las entradas de cambios
Una entrada de cambio representa el estado del archivo o la unidad compartida en un momento determinado. Un cambio no proporciona un delta entre las revisiones. Las aplicaciones que necesiten saber qué propiedades cambiaron deben conservar el estado conocido anteriormente del elemento y compararlo.
Dado que los cambios representan el estado actual de un elemento, las entradas de cambios individuales pueden invalidarse y reemplazarse por una entrada de cambios más reciente para el elemento correspondiente.
Tombstones
Las entradas de cambio de los elementos que ya no están disponibles para un usuario se marcan como deleted en la entrada de cambio. Solo el ID del artículo está disponible en la entrada de cambio.
Hacer un seguimiento de las unidades compartidas
Cada unidad compartida tiene su propio registro de cambios. Aunque un usuario pueda ser miembro de una unidad compartida, ciertos cambios solo se reflejan en el registro de cambios de la unidad compartida y nunca en el registro de cambios del usuario. Si un archivo pertenece a una unidad compartida, incluso si el archivo aún aparece en el registro de cambios del usuario en algún momento en el pasado, volver a reproducir solo el registro de cambios del usuario no actualizará correctamente el estado del archivo. En su lugar, debes volver a reproducir el registro de cambios de la unidad compartida para capturar todos los cambios.
Qué se incluye en el registro de cambios de un usuario
El registro de cambios de un usuario incluye cambios en las unidades compartidas de las que es miembro, así como cambios en los archivos del corpus del usuario. Para obtener más información sobre los corpus, consulta Descripción general de los cambios y las revisiones.
Estos cambios en la unidad compartida aparecen en el registro de cambios del usuario:
- El usuario se convierte en miembro de una unidad compartida.
- El usuario ya no es miembro de una unidad compartida.
- Hay un cambio directamente relevante en una unidad compartida de la que el usuario es miembro, por ejemplo:
- Cambió el nivel de acceso del usuario en esa unidad compartida.
- Se cambia el nombre de la unidad compartida.
Cuando un usuario se convierte en miembro de una unidad compartida, aparece un solo evento de cambio para la unidad compartida en el registro de cambios del usuario. Esto implica acceso a todos los elementos de la unidad compartida. El usuario no recibe cambios en los elementos contenidos en la unidad compartida cuando se convierte en miembro.
Los miembros de una unidad compartida pueden ver los eventos de cambio de los elementos de una unidad compartida según su uso. Sin embargo, las aplicaciones no deben depender de estos eventos cuando el usuario es miembro de la unidad compartida. En su lugar, usa el registro de cambios del viaje compartido para hacer un seguimiento de los cambios.
Si se le otorga acceso de archivos a elementos individuales de una unidad compartida a un usuario que no es miembro, se realiza un seguimiento de los cambios en esos elementos en el registro de cambios del usuario. Esto es lo mismo que sucede con los elementos de Drive no compartidos que se comparten directamente con los usuarios.
Cambios que aparecen en el registro de cambios de una unidad compartida
Si un usuario es miembro de una unidad compartida, puede acceder al registro de cambios de esa unidad, que contiene lo siguiente:
- Cualquier cambio en la unidad compartida, como agregar o quitar un miembro
- Dirigir los cambios a los elementos contenidos en la unidad compartida
Cómo sincronizar permisos y capacidades
Los cambios de permisos en la unidad compartida o en los elementos dentro de ella solo se reflejan en el elemento en sí. Si bien todos los elementos secundarios directos o indirectos de ese elemento heredarán este cambio, no habrá una entrada independiente en el registro de cambios para cada uno de esos elementos. Los clientes deben propagar las nuevas funciones o volver a recuperar cada elemento si un elemento superior cambió para reconstruir completamente los cambios.