Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 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 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 feitas 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 mudanças do usuário e no registro de mudanças 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 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 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.
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 arquivo do editor podem ser mescladas, então a resposta da API pode não mostrar todas as mudanças feitas em um arquivo.
Para baixar uma revisão de conteúdo de arquivo blob ou exportar uma revisão de conteúdo de documento do Google Workspace, consulte Baixar e exportar arquivos.
[null,null,["Última atualização 2025-08-21 UTC."],[],[],null,["# Changes and revisions overview\n\nGoogle Drive maintains an automatic history of modifications, which can help\nusers track file changes and content revisions. In the revision history, users\ncan see what edits have been made and can revert to a specific version of a file\nwith specific edits.\n\nThe following terms are relevant to the changes and revisions resources of the\nGoogle Drive API:\n\n*Access Control List (ACL)*\n: The list of all permission resources associated with a file, folder, or shared\n drive.\n\n*Change*\n: An alteration made to a file's content or metadata of a file or shared drive.\n\n*User change log*\n\n: A record of all changes that a user made to every editable file in their My\n Drive, such as a Google Docs, Sheets, or a\n Slides. For members of a shared drive, the user change log\n also includes entries about shared drive membership, user access levels to\n items in that shared drive, and shared drive name changes.\n\n | **Note:** Even if several users can access the same file, not all changes to that file are reflected in every users' change log. For example, when a user opens the file for the first time, or marks the file as Starred, those changes only appear in that users' change log. As another example, when a file's ACL is changed, it's only reflected in the change log of the following users: The file's owner, any service accounts on the ACL, and any users directly impacted by the ACL change.\n\n*Shared drive change log*\n\n: A record of all changes to a shared drive, such as additions or removals of\n users, and all changes to items on that shared drive. A change to an item\n within a shared drive appears in both the *user change log* and shared drive\n change log.\n\n*Change log entry*\n\n: A record of a change made to a file's content or metadata of a file or shared\n drive. A change log entry indicates the user who made the change, the\n timestamp, and an ID. There can only be one entry per file or shared drive\n in the change log at a time. Each time that file or shared drive changes, a\n new ID is created for that entry, and it replaces the previous entry.\n\n*Revision*\n\n: A version of the file representing a change to the file's contents (not\n metadata). Each revision can be accessed using the [`revisions`](/workspace/drive/api/reference/rest/v3/revisions) resource within the Drive API.\n\n*Head revision*\n\n: The most current version of a file. The `headRevisionId` can be accessed using\n the [`files`](/workspace/drive/api/reference/rest/v3/files) resource within the\n Drive API. The `headRevisionId` is only available for blob files\n in Drive.\n\n*Blob revision*\n\n: A version of an unmodifiable binary file, such as an image, video, or PDF. If\n the blob revision is the only revision of the binary file, it cannot be\n deleted. A new blob can be uploaded as a new *revision* , which becomes the\n new *head revision* of that file.\n\n Any blob file revision, other than the head revision, that's not designated\n as \"Keep Forever\" is purgeable. Purgeable revisions are typically preserved\n for 30 days, but can be purged earlier if a file has 100 revisions that\n aren't designated as \"Keep Forever\" and a new revision is uploaded.\n\n For more information on setting blob revisions as \"Keep Forever\", see\n [Specify revisions to save from auto\n delete](/workspace/drive/api/guides/manage-revisions#specify-revisions).\n\n*Revision history*\n\n: A record of all revisions of a file in chronological order. A change to a\n Docs, Sheets, or Slides file\n gets a new revision. Each time the content changes, Drive\n creates a new revision history entry for that file. However, these editor\n file revisions may be merged together, so the API response might not show\n all changes to a file.\n\nRelated topics\n--------------\n\n- To identify where the change you want to track is recorded, see [Identify\n which change log to track](/workspace/drive/api/guides/about-changelogs).\n- To set up change tracking for users and shared drives, see [Track changes\n for users and shared drives](/workspace/drive/api/guides/about-changes).\n- To download a blob file content revision or to export a Google Workspace document content revision, see [Download and export\n files](/workspace/drive/api/guides/manage-downloads).\n- To publish a revision, see [Manage file\n revisions](/workspace/drive/api/guides/manage-revisions).\n- To set up change notifications, see [Notifications for resource changes](/workspace/drive/api/guides/push)."]]
