Visão geral de mudanças e revisões

O Google Drive mantém um histórico automático de modificações, que pode ajudar os usuários a acompanhar as mudanças nos arquivos e nas revisões de conteúdo. No histórico de revisões, os usuários podem conferir as edições que foram feitas e reverter para uma versão específica de um arquivo com edições específicas.

Os termos a seguir são relevantes para os recursos de alterações e revisões da API Google Drive:

Lista de controle de acesso (ACL)
Lista de todos os recursos de permissão associados a um arquivo, uma pasta ou um drive compartilhado.
Alterar
Uma alteração feita no conteúdo ou nos metadados de um arquivo ou drive compartilhado.
Registro de alterações do usuário
Um registro de todas as alterações que um usuário fez em todos os arquivos editáveis no Meu Drive, como Documentos, Planilhas ou Apresentações Google. Para os membros de um drive compartilhado, o registro de alterações de usuários também inclui entradas sobre a associação, os níveis de acesso do usuário aos itens e as alterações de nome dos drives compartilhados.
Registro de alterações do drive compartilhado
Um registro de todas as alterações em um drive compartilhado, como as adições ou remoções de usuários, e todas as alterações nos itens desse drive compartilhado. Uma alteração em um item em um drive compartilhado aparece no registro de alterações do usuário e do drive compartilhado.
Entrada de registro de alterações
Um registro de uma alteração feita no conteúdo ou nos metadados de um arquivo ou drive compartilhado. Uma entrada do registro de alterações indica o usuário que fez a alteração, o carimbo de data/hora e um ID. Só pode haver uma entrada por arquivo ou drive compartilhado no registro de alterações por vez. Sempre que esse arquivo ou drive compartilhado é alterado, um ID é criado para essa entrada e substitui a entrada anterior.
Revisão
Uma versão do arquivo que representa uma alteração no conteúdo do arquivo (não nos metadados). Cada revisão pode ser acessada usando o recurso de revisão na API Drive.
Revisão principal
A versão mais atual de um arquivo.
Revisão do Blob

Uma versão de um arquivo binário não modificável, como imagem, vídeo ou PDF. Se a revisão de blob for a única revisão do arquivo binário, ela não poderá ser excluída. Um novo blob pode ser enviado como uma nova revisão, que se torna a nova revisão principal desse arquivo.

As revisões de blob podem ser definidas como "Manter para sempre", o que significa que a revisão não pode ser limpa automaticamente. É possível definir até 200 revisões como "Manter para sempre". A revisão principal nunca é limpa automaticamente.

Qualquer revisão, exceto a principal, que não seja designada como "Manter para sempre" pode ser limpa. As revisões purificáveis geralmente são preservadas por 30 dias, mas poderão ser limpas antes se um arquivo tiver 100 revisões que não forem designadas como "Manter para sempre" e uma nova revisão for enviada.

O campo keepForever do recurso Revisions é usado para definir uma revisão como "Manter para sempre". Além disso, é possível chamar revisions.delete para excluir uma revisão, mesmo quando ela estiver marcada como "Manter para sempre".

Histórico de revisões

Um registro de todas as revisões de um arquivo em ordem cronológica. Uma alteração em um arquivo do Documentos, Planilhas ou Apresentações recebe uma nova revisão. Cada vez que o conteúdo é alterado, o Drive cria uma nova entrada no histórico de revisões para o arquivo. No entanto, essas revisões de arquivo do editor podem ser mescladas. Portanto, a resposta da API pode não mostrar todas as mudanças em um arquivo.

Assista a este vídeo para saber como gerenciar revisões com a API Google Drive:

Próximas etapas