Gerenciar revisões de arquivos

A API Google Drive oferece o recurso revisions para que você possa fazer o download e publicar revisões de arquivos. Para mais detalhes sobre a terminologia de revisão, consulte Visão geral de mudanças e revisões.

Especificar revisões para salvar da exclusão automática

O Google Drive exclui automaticamente revisões mais antigas que não são mais de interesse para o usuário. Para evitar que isso aconteça, defina a flag booleana keepRevisionForever como true para marcar as revisões que você não quer que o Drive exclua.

Fazer o download de uma revisão

Para fazer o download da revisão mais recente, use o método files.download. Para mais informações, consulte Gerenciar operações de longa duração.

Publicar uma revisão

Para publicar uma revisão do Documentos, das Planilhas ou das Apresentações Google, defina a propriedade published para esse arquivo no recurso revisions. Essa propriedade não pode ser definida para revisões do Google Sites usando a API Drive.

O Apresentações Google e o Desenhos Google não oferecem suporte à publicação de revisões específicas. Somente a republicação automática da revisão mais recente é aceita. Para publicar Apresentações e Desenhos, defina publishAuto como true.

Se o arquivo for criado em um domínio do Google Workspace, a propriedade publishedOutsideDomain vai indicar se a revisão é acessível por qualquer pessoa ou se é restrita aos usuários do domínio. Para arquivos do Sites, essa propriedade indica se uma permissão type=anyone existe.

As revisões publicadas não refletem as mudanças feitas em um arquivo, a menos que a propriedade publishAuto seja definida. Se essa propriedade for definida como true, as revisões mais recentes de um arquivo serão publicadas automaticamente, substituindo as anteriores. Esse comportamento também é controlado pela caixa de seleção "Refazer a publicação automaticamente quando houver alterações" na interface do Drive. As planilhas e os desenhos só oferecem suporte à republicação automática e exigem que a propriedade publishAuto seja definida como true. Para arquivos do Sites, publishAuto é sempre false.