Para apps do Google Drive que precisam acompanhar as mudanças nos itens, a coleção de mudanças oferece uma maneira eficiente de detectar alterações. A coleção funciona fornecendo o estado atual de cada item, se e 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 seu próprio registro de mudanças em itens de interesse.
Para acompanhar as mudanças em todos os itens visíveis a um usuário, é necessário reproduzir o registro de alterações do usuário e de todos os drives compartilhados em que o usuário é membro.
Ativar as entradas de mudança
Uma entrada de mudança representa o estado do arquivo ou do drive compartilhado em um determinado momento. Uma mudança não fornece um delta entre as revisões. Os aplicativos que precisam saber quais propriedades mudaram precisam manter o estado conhecido anteriormente do item e fazer uma 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
As 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 mudança.
Acompanhar drives compartilhados
Cada drive compartilhado tem um registro de alterações. Mesmo que um usuário seja membro de um drive compartilhado, algumas mudanças são refletidas apenas no registro de mudanças do drive compartilhado e nunca no registro de mudanças do usuário. Se um arquivo pertence a um drive compartilhado, mesmo que ele ainda apareça no registro de alterações do usuário em algum momento do passado, a reprodução do registro de alterações do usuário não atualizará corretamente o status do arquivo. Em vez disso, você precisa reproduzir o registro de alterações do drive compartilhado para capturar todas as mudanças.
O que está incluído no registro de alterações de um usuário
O registro de mudanças de um usuário inclui alterações em drives compartilhados dos quais ele participa, bem como mudanças em arquivos no corpus do usuário. Para mais informações sobre corpora, consulte Visão geral de mudanças e revisões.
Essas mudanças 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 é mais membro de um drive compartilhado.
- Há uma mudança diretamente relevante em um drive compartilhado em que o usuário é
participante, por exemplo:
- O nível de acesso do usuário nesse drive compartilhado mudou.
- O drive compartilhado é renomeado.
Quando um usuário se torna participante de um drive compartilhado, um único evento de mudança para o drive compartilhado aparece no registro de mudanças do usuário. Isso implica acesso a todos os itens no drive compartilhado. O usuário não recebe as mudanças nos itens contidos no drive compartilhado quando se torna membro.
Os membros de um drive compartilhado podem conferir eventos de alteração de itens em um drive compartilhado com base no uso. No entanto, os aplicativos não devem depender desses eventos quando o usuário é membro do drive compartilhado. Em vez disso, use o registro de alterações do drive compartilhado para acompanhar as mudanças.
Se um participante não tiver acesso a arquivos de itens individuais em um drive compartilhado, as alterações nesses itens serão rastreadas no registro de alterações do usuário. Isso é o mesmo que os itens do Drive não compartilhados que são compartilhados diretamente com os usuários.
Mudanças que aparecem no registro de alterações de um drive compartilhado
Se um usuário for participante de um drive compartilhado, ele poderá acessar o registro de mudanças desse drive, que contém:
- Qualquer mudança no próprio drive compartilhado, como adição ou remoção de um participante
- Direciona as mudanças nos itens contidos no drive compartilhado.
Como sincronizar permissões e recursos
As mudanças de permissão no drive compartilhado ou nos itens dentro dele são refletidas apenas no próprio item. Embora todos os filhos diretos ou indiretos desse item herdem essa mudança, não há uma entrada separada no registro de mudanças para cada um desses itens. Os clientes precisam propagar os novos recursos ou buscar novamente cada item se um pai tiver mudado para reconstruir totalmente as mudanças.