Para apps do Google Drive que precisam acompanhar as mudanças nos itens do Drive, a coleção Changes oferece uma maneira eficiente de detectar mudanças. A coleta funciona fornecendo o estado atual de cada item, se e somente se o item tiver mudado desde um determinado momento.
O Google Drive mantém um registro de mudanças para cada usuário e drive compartilhado. Cada um tem o próprio registro de mudanças nos itens de interesse.
Para acompanhar as mudanças em todos os itens visíveis para um usuário, é necessário reproduzir o registro de mudanças do usuário e os registros de mudanças de todos os drives compartilhados de que ele participa.
Ativar 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 revisões. Os aplicativos que precisam saber quais propriedades mudaram precisam manter o estado conhecido anteriormente do item e comparar.
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.
Tombstones
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 mudanças. Mesmo que um usuário seja participante de um drive compartilhado, algumas mudanças só são refletidas no registro de mudanças do drive compartilhado e nunca no registro de mudanças do usuário. Se um arquivo pertencer a um drive compartilhado, mesmo que ele tenha aparecido no registro de mudanças do usuário em algum momento no passado, reproduzir apenas o registro de mudanças do usuário não vai atualizar corretamente o status do arquivo. Em vez disso, reproduza o registro de mudanças 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 mudanças de um usuário inclui alterações nos drives compartilhados de que ele participa e nos arquivos do corpus dele. 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 de que o usuário é membro, por exemplo:
- O nível de acesso do usuário no drive compartilhado mudou.
- O drive compartilhado é renomeado.
Quando um usuário se torna participante de um drive compartilhado, um único evento de mudança do 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 mudanças nos itens contidos no drive compartilhado quando se torna membro.
Os participantes de um drive compartilhado podem ver eventos de mudança de itens com base no uso. No entanto, os aplicativos não devem depender desses eventos quando o usuário é participante do drive compartilhado. Em vez disso, use o registro de mudanças do drive compartilhado para acompanhar as alterações.
Se um usuário sem participação receber acesso a itens individuais em um drive compartilhado, as mudanças feitas nesses itens serão rastreadas no registro de mudanças do usuário. É o mesmo que itens do Drive não compartilhados que são compartilhados diretamente com os usuários.
Mudanças que aparecem em um registro de alterações do drive compartilhado
Se um usuário for participante de um drive compartilhado, ele poderá acessar o registro de mudanças do drive, que contém:
- Qualquer mudança no próprio drive compartilhado, como a adição ou remoção de um membro
- Fazer mudanças diretamente nos itens contidos no drive compartilhado.
Sincronização de permissões e recursos
As mudanças de permissão no drive compartilhado ou nos itens dentro dele são refletidas apenas no item em si. Embora todos os filhos diretos ou indiretos desse item herdem essa mudança, não haverá uma entrada separada no registro de mudanças para cada um deles. Os clientes precisam propagar os novos recursos ou buscar novamente cada item se um elemento principal tiver sido alterado para reconstruir totalmente as mudanças.