Haz un seguimiento de los cambios de los usuarios y las unidades compartidas

En el caso de las apps para Google Drive que necesiten realizar un seguimiento de los cambios en los elementos de Drive, la colección Cambios proporciona una forma eficiente de detectar los cambios. La colección funciona proporcionando el estado actual de cada elemento, siempre y cuando este haya cambiado desde un momento determinado.

Google Drive mantiene un registro de cambios de cada usuario y unidad compartida. Cada uno tiene su propio registro de cambios en los elementos que les interesan.

Para realizar un seguimiento de los cambios de todos los elementos visibles para un usuario, se deben volver a reproducir tanto los registros de cambios del usuario como los de todas las unidades compartidas a las que es miembro.

Habilitar entradas de cambio

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 necesitan saber qué propiedades cambiaron deben conservar el estado del elemento conocido anteriormente y compararlo.

Dado que los cambios representan el estado actual de un elemento, las entradas de cambio individuales pueden invalidarse y reemplazarse por una entrada de cambio más reciente para el elemento correspondiente.

Lápidas

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.

Haz un seguimiento de las unidades compartidas

Cada unidad compartida tiene su propio registro de cambios. Aunque un usuario sea miembro de una unidad compartida, ciertos cambios solo se reflejan en el registro de cambios de la unidad compartida y nunca en el del usuario. Si un archivo pertenece a una unidad compartida, incluso si el archivo sigue apareciendo en el registro de cambios del usuario en algún momento, 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 los cambios en las unidades compartidas de las que es miembro, así como los cambios en los archivos del corpus del usuario. Para obtener más información sobre corpus, consulta Descripción general de cambios y revisiones.

Los cambios de 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 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, aparece un solo evento de cambios para esa unidad en el registro de cambios del usuario. lo que implica el acceso a todos los elementos de la unidad compartida. Cuando se convierte en miembro, el usuario no recibe cambios para los elementos contenidos en la unidad compartida.

Los miembros de una unidad compartida podrían ver eventos de cambio de los elementos de la unidad compartida en función de 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 de la unidad compartida para hacer un seguimiento de los cambios.

Si a un usuario que no es miembro se le otorga acceso a archivos para elementos individuales de una unidad compartida, se hará un seguimiento de los cambios en esos elementos en el registro de cambios del usuario. Es lo mismo que los elementos no compartidos de Drive 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 compartida, que contiene lo siguiente:

  • Cualquier cambio en la unidad compartida en sí, 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 la unidad compartida o de los elementos dentro de ella solo se reflejan en el elemento. Si bien todos los elementos secundarios directos o indirectos de ese elemento heredarán este cambio, no habrá una entrada separada en el registro de cambios para cada uno de esos elementos. Los clientes deben propagar las nuevas capacidades o volver a recuperar cada elemento si un elemento superior cambió para reconstruir por completo los cambios.