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 mudanças 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, pasta ou unidade compartilhada.
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 no 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 mudança em um item em um drive compartilhado aparece no registro de alterações do usuário e no registro de alterações do drive compartilhado.
Alterar a entrada do registro
Um registro de uma mudança 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 de cabeça
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 de blobs podem ser definidas como "Manter para sempre", o que significa que a revisão não pode ser expurgada 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 expurgáveis geralmente são preservadas por 30 dias, mas podem ser expurgadas 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 está 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 mudança em um arquivo do Documentos, Planilhas ou Apresentações gera uma nova revisão. Toda vez 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 arquivo do editor podem ser mescladas, portanto, a resposta da API pode não mostrar todas as alterações em um arquivo.

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

Próximas etapas