En el caso de las apps para Google Drive que necesitan hacer un seguimiento de los cambios realizados en los elementos de Drive, la La recopilación de cambios proporciona una manera eficiente de detectar cambios. La colección funciona proporcionando el estado actual de cada solo si el elemento 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 los cambios en los elementos que les interesan.
Para realizar un seguimiento de los cambios en todos los elementos visibles para un usuario, tanto el registro de cambios del usuario como la registros de cambios de todas las unidades compartidas de las que es miembro deben volver a reproducirse.
Habilitar entradas de cambio
Una entrada de cambio representa el estado del archivo o la unidad compartida en un punto determinado a tiempo. Un cambio no proporciona un delta entre revisiones. Aplicaciones que necesiten saber qué propiedades cambiaron deben conservar la el estado conocido previamente del elemento y compararlo.
Dado que los cambios representan el estado actual de un elemento, los cambios individuales pueden invalidarse y reemplazarse por una entrada de cambio más reciente para el elemento correspondiente.
Lápidas
Las entradas de cambio de 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 puede ser miembro de una unidad compartida, algunos cambios solo se reflejan en la modificación de la unidad compartida registro y nunca en el registro de cambios del usuario. Si un archivo pertenece a una unidad compartida, incluso si el archivo aún aparecía en el registro de cambios del usuario en algún momento del anterior, volver a reproducir solo el registro de cambios del usuario no actualizará correctamente el historial estado. En cambio, debes volver a reproducir el registro de cambios de la unidad compartida cambios.
Qué se incluye en el registro de cambios de un usuario
El registro de cambios de un usuario también incluye los cambios realizados en las unidades compartidas de las que es miembro como cambios en los archivos del corpus del usuario. Para obtener más información sobre 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 en la que el usuario es un
miembro, por ejemplo:
- Cambió el nivel de acceso del usuario en esa unidad compartida.
- Se cambió el nombre de la unidad compartida.
Cuando un usuario se convierte en miembro de una unidad compartida, un solo evento de cambio de la unidad compartida aparece en el registro de cambios del usuario. Esto implica acceso a todos los elementos de la unidad compartida. El usuario no recibe cambios por elementos contenidos en la unidad compartida cuando se conviertan en miembros
Los miembros de una unidad compartida pueden ver los eventos de cambio de los elementos incluidos en ella en su uso. Sin embargo, las aplicaciones no deben basarse en estos eventos cuando la usuario es miembro de la unidad compartida. En su lugar, usa el registro de cambios de la unidad compartida para realizar un seguimiento de los cambios.
Si a un usuario que no es miembro se le otorga acceso a los archivos de elementos individuales de una unidad compartida, de los cambios realizados en esos elementos se realiza un seguimiento en el registro de cambios del usuario. Esto es igual como 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 cambio correspondiente registro que contiene lo siguiente:
- Cualquier cambio en la unidad compartida, como la adición o eliminación de un miembro
- Cambios directos en los elementos contenidos en la unidad compartida
Sincronización de permisos y capacidades
Los cambios en los permisos de una unidad compartida o de los elementos incluidos en ella solo se aplican en el elemento en sí. Si bien todos los elementos secundarios directos o indirectos de el elemento heredará este cambio, no habrá una entrada separada en el de registro de cada uno de esos elementos. Los clientes deben propagar las nuevas capacidades o recuperar cada elemento si un elemento superior ha cambió para reconstruir completamente los cambios.