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 mudanças de arquivos e revisões de conteúdo. No histórico de revisões, os usuários podem conferir quais edições 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)
A 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 feitas por um usuário em todos os arquivos editáveis no "Meu Drive", como Documentos, Planilhas ou Apresentações Google. Para participantes de um drive compartilhado, o registro de mudanças do usuário também inclui entradas sobre a participação no drive compartilhado, os níveis de acesso do usuário aos itens nesse drive e as mudanças de nome do drive compartilhado.
Registro de alterações do drive compartilhado
Um registro de todas as mudanças em um drive compartilhado, como adições ou remoções de usuários, e todas as mudanças nos itens desse drive. Uma alteração em um item em um drive compartilhado aparece nos registros de alterações do usuário e do drive compartilhado.
Alterar a entrada do registro
Um registro de uma alteração feita no conteúdo ou nos metadados de um arquivo ou drive compartilhado. Uma entrada de registro de mudança indica o usuário que fez a mudança, o carimbo de data/hora e um ID. Só é possível ter uma entrada por arquivo ou drive compartilhado no registro de alterações por vez. Sempre que esse arquivo ou drive compartilhado muda, um novo ID é criado para essa entrada e ela substitui a anterior.
Revisão
Uma versão do arquivo que representa uma alteração no conteúdo do arquivo (não metadados). Cada revisão pode ser acessada usando o recurso de revisão na API Drive.
Revisão principal
A versão mais recente de um arquivo.
Revisão de blob

Uma versão de um arquivo binário não modificável, como uma imagem, um vídeo ou um PDF. Se a revisão do 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 do Blob podem ser definidas como "Keep Forever", o que significa que a revisão não pode ser limpa automaticamente. Até 200 revisões podem ser definidas como "Manter indefinidamente". A revisão principal nunca é limpa automaticamente.

Qualquer revisão, exceto a principal, que não seja designada como "Manter para sempre", pode ser excluída. As revisões que podem ser excluídas geralmente são preservadas por 30 dias, mas podem ser excluídas antes se um arquivo tiver 100 revisões que não são 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 indefinidamente".

Histórico de revisões

Um registro de todas as revisões de um arquivo em ordem cronológica. Uma mudança em um arquivo do Documentos, Planilhas ou Apresentações gera uma nova revisão. Sempre que o conteúdo muda, o Drive cria uma nova entrada de histórico de revisões para esse arquivo. No entanto, essas revisões de arquivos 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