Para aplicativos do Google Drive que precisam controlar as alterações em itens no Google Drive, o A coleta de alterações fornece uma maneira eficiente de e detectar alterações. A coleção funciona fornecendo o estado atual de cada item, se e somente se o item tiver sido alterado 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 alterações em itens que são de 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 o os registros de alteração de todos os drives compartilhados em que o usuário é membro precisam ser reproduzidos novamente.
Ativar entradas de alteração
Uma entrada de alteração representa o estado do arquivo ou drive compartilhado em um determinado momento com o tempo. Uma alteração não fornece um delta entre as revisões. Aplicativos que precisam saber quais propriedades foram alteradas devem persistir o estado previamente conhecido do item e compará-los.
Como as mudanças representam o estado atual de um item, as mudanças individuais entradas podem ser invalidadas e substituídas por uma entrada de alteração mais recente para o item correspondente.
Lápides
As entradas de alteração de itens que não estão mais disponíveis para um usuário estão marcadas como deleted
na entrada da alteração. Somente o ID do item fica disponível na entrada de alteração.
Rastrear drives compartilhados
Cada drive compartilhado tem um registro de alterações próprio. Mesmo que um usuário seja membro de um drive compartilhado, algumas alterações serão refletidas apenas na alteração do drive compartilhado e nunca no registro de alterações do usuário. Se um arquivo pertencer a um drive compartilhado, faça o seguinte: mesmo se o arquivo ainda aparecer no registro de alterações do usuário em algum momento do anteriores, a repetição do registro de alterações do usuário por si só não atualizará corretamente a o status atual da conta. Em vez disso, acesse novamente o registro de alterações do drive compartilhado para capturar todas mudanças.
O que está incluído no registro de alterações de um usuário
O registro de alterações de um usuário também inclui alterações nos drives compartilhados de que ele é participante como alterações nos arquivos do corpus do usuário. Para mais informações sobre o corpora, consulte Visão geral de alterações 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 é mais participante de um drive compartilhado.
- Há uma alteração diretamente relevante em um drive compartilhado em que o usuário é
membro, 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 do drive compartilhado aparece no registro de alterações do usuário. Isso implica a todos os itens no drive compartilhado. O usuário não recebe alterações para itens no drive compartilhado quando eles se tornarem participantes.
Os participantes de um drive compartilhado podem ver eventos de alteração nos itens dele com base sobre o uso deles. No entanto, os aplicativos não devem depender desses eventos quando os o usuário é participante do drive compartilhado. Em vez disso, use o registro de alterações do drive compartilhado para: acompanhar as alterações.
Se um não membro tiver acesso a arquivos de itens específicos em um drive compartilhado: as alterações nesses itens são rastreadas no registro de alterações do usuário. Isto é igual como itens do Drive não compartilhados diretamente com os usuários.
Alterações que aparecem em um registro de alterações do drive compartilhado
Se o usuário for participante de um drive compartilhado, ele poderá acessar a alteração desse drive registro que contém:
- Alterações 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 um drive compartilhado ou itens dentro dele são apenas refletidas no item. Embora todos os filhos diretos ou indiretos desse item herdará esta alteração, e não haverá uma entrada separada na alteração para cada um desses itens. Os clientes precisam os novos recursos ou refaça a busca de cada item se um pai tiver mudou a fim de reconstruir completamente as alterações.