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 e revisões de conteúdo dos arquivos. 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.
Mudança
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 que um usuário fez em cada arquivo editável no Meu Drive, como um arquivo do Documentos, Planilhas ou Apresentações Google. Para os membros de um drive compartilhado, o registro de alterações 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 no registro de alterações do usuário e no registro de alterações 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 alterações 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 alterações por vez. Cada vez que o arquivo ou drive compartilhado muda, um novo ID é criado para essa entrada, e ele substitui a entrada anterior.

Revisão

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

Revisão principal

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

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 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.

Qualquer revisão de arquivo de blob, que não seja a revisão principal, que não esteja designada como "Manter indefinidamente" pode ser limpa. As revisões limpas normalmente são preservadas por 30 dias, mas podem ser limpas antes se um arquivo tiver 100 revisões que não estejam designadas como "Manter indefinidamente" e uma nova revisão for enviada.

Para mais informações sobre como definir revisões de blob como "Manter indefinidamente", 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 do Documentos, Planilhas ou Apresentações Google recebe uma nova revisão. Cada 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 arquivos do editor podem ser mescladas, então a resposta da API pode não mostrar todas as mudanças em um arquivo.