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 unidade compartilhada.
Registro de alterações do usuário

Um registro de todas as mudanças feitas por um usuário em cada arquivo editável no Meu Drive, como um documento, uma planilha ou uma apresentação 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 compartilhado. Uma mudança em um item dentro de um drive compartilhado aparece nos registros de mudanças do usuário e do drive compartilhado.

Entrada do 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 mudanças indica o usuário que fez a mudança, o carimbo de data/hora e um ID. Só pode haver uma entrada por arquivo ou drive compartilhado no registro de mudanças por vez. Cada vez que o arquivo ou a unidade compartilhada 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 "Revision" na API Drive.

Revisão principal

A versão mais atual 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 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 gera uma nova revisão. Cada vez 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 arquivo do editor podem ser mescladas, então a resposta da API pode não mostrar todas as mudanças em um arquivo.