Para os apps do Google Drive que precisam acompanhar as mudanças nos itens, a coleção de mudanças é uma maneira eficiente de detectar mudanças. A coleção funciona fornecendo o estado atual de cada item somente se ele tiver mudado desde um determinado momento.
O Google Drive mantém um registro de alterações para cada usuário e drive compartilhado. Cada um tem o próprio registro das mudanças nos itens que são do seu interesse.
Para rastrear as alterações de todos os itens visíveis para um usuário, o registro de alterações do usuário e de todos os drives compartilhados de que o usuário participa precisam ser repetidos.
Ativar entradas de alteração
Uma entrada de alteração representa o estado do arquivo ou drive compartilhado em um determinado momento. As alterações não fornecem um delta entre as revisões. Os aplicativos que precisam saber quais propriedades foram alteradas precisam manter o estado anteriormente conhecido do item e fazer a comparação.
Como as mudanças representam o estado atual de um item, as entradas de mudança individuais podem ser invalidadas e substituídas por uma entrada de mudança mais recente para o item correspondente.
Lápides
Entradas de mudança para itens que não estão mais disponíveis para um usuário são marcadas como deleted
na entrada de mudança. Somente o ID do item está disponível na entrada de alteração.
Acompanhar drives compartilhados
Cada drive compartilhado tem um registro de alterações próprio. Mesmo que um usuário participe de um drive compartilhado, algumas alterações só aparecem no registro de alterações do drive compartilhado, nunca no registro de alterações do usuário. Se um arquivo pertencer a um drive compartilhado, mesmo que ele ainda apareça no registro de alterações do usuário em algum momento anterior, repetir o registro de alterações do usuário não vai atualizar corretamente o status do arquivo. Em vez disso, você precisa repetir o registro de alterações do drive compartilhado para capturar todas as alterações.
O que está incluído no registro de alterações de um usuário
O registro de alterações de um usuário inclui alterações nos drives compartilhados de que ele é membro e nos arquivos do corpus. Para saber mais sobre o corpora, consulte Visão geral de mudanças e revisões.
Estas alterações no drive compartilhado aparecem no registro de alterações do usuário:
- O usuário se torna participante de um drive compartilhado.
- O usuário não participa mais de um drive compartilhado.
- Há uma alteração diretamente relevante em um drive compartilhado de que o usuário é um
participante, por exemplo:
- O nível de acesso do usuário nesse drive compartilhado mudou.
- O drive compartilhado foi renomeado.
Quando um usuário se torna participante de um drive compartilhado, um único evento de alteração desse drive aparece no registro de alterações. ou seja, têm acesso a todos os itens no drive compartilhado. O usuário não recebe alterações nos itens contidos no drive compartilhado quando se torna participante.
Os participantes de um drive compartilhado podem ver eventos de alteração de itens com base no uso deles. No entanto, os aplicativos não podem depender desses eventos quando o usuário for membro do drive compartilhado. Em vez disso, use o registro de alterações do drive compartilhado para acompanhá-las.
Se uma pessoa que não é participante tiver acesso a arquivos específicos em um drive compartilhado, as mudanças nesses itens vão ser rastreadas no registro do usuário. Esses itens são iguais aos itens do Drive não compartilhados que são compartilhados diretamente com os usuários.
Alterações que aparecem em um registro de alterações de um drive compartilhado
Se um usuário for participante de um drive compartilhado, ele poderá acessar o registro de alterações desse drive, que contém:
- Qualquer alteração no próprio drive compartilhado, como a adição ou remoção de um participante
- Alterações diretas nos itens contidos no drive compartilhado.
Permissões e recursos de sincronização
As mudanças nas permissões de drives compartilhados ou itens dentro de um drive compartilhado são refletidas apenas no próprio item. Embora todos os filhos diretos ou indiretos desse item herdem essa mudança, não haverá uma entrada separada no registro de alterações para cada um desses itens. Os clientes precisam propagar os novos recursos ou buscar novamente cada item, caso um pai tenha mudado, para reconstruir completamente as mudanças.