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

O Google Drive mantém um histórico automático de modificações, o que pode ajudar os usuários a acompanhar as mudanças nos arquivos e as revisões de conteúdo. No histórico de revisões, os usuários podem ver 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 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 mudanças feitas por um usuário em todos os arquivos editáveis no Meu Drive, como um arquivo do Documentos, Planilhas ou Apresentações Google. Para participantes de um drive compartilhado, o registro de alterações do usuário também inclui entradas sobre a associação ao 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 em itens nesse 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.

Entrada de registro de alterações

Um registro de uma mudança feita no conteúdo ou nos metadados de um arquivo ou drive compartilhado. Uma entrada de 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. Cada vez que o arquivo ou o drive compartilhado muda, um novo ID é criado para essa entrada, substituindo a anterior.

Revisão

Uma versão do arquivo que representa uma mudança no conteúdo dele (não nos metadados). Cada revisão pode ser acessada usando o recurso revisions na API Drive.

Revisão principal

A versão mais atual de um arquivo. O headRevisionId pode ser acessado usando o recurso files na API Drive. O headRevisionId só está disponível para arquivos blob no Drive.

Revisão do 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 por upload como uma nova revisão, que se torna a nova revisão principal desse arquivo.

Qualquer revisão de arquivo blob, exceto a principal, que não seja designada como "Manter indefinidamente" pode ser excluída. As revisões passíveis de exclusão geralmente são preservadas por 30 dias, mas podem ser excluídas antes se um arquivo tiver 100 revisões que não estão designadas como "Manter para sempre" e uma nova revisão for enviada.

Para mais informações sobre como definir revisões de blob como "Manter para sempre", consulte Especificar revisões para salvar da exclusão automática.

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 dos Documentos, Planilhas ou Apresentações recebe uma nova revisão. Sempre que o conteúdo muda, o Drive cria uma nova entrada no histórico de revisões desse arquivo. No entanto, essas revisões de arquivos do editor podem ser mescladas, então a resposta da API pode não mostrar todas as mudanças em um arquivo.