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 as 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 e do Apresentações, 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.

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

As revisões publicadas não refletem as alterações feitas em um arquivo, a menos que a propriedade publishAuto esteja 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 "Republicar automaticamente quando houver alterações" na interface do Drive. Para arquivos do Sites, publishAuto é sempre false.