Fazer o download e publicar revisões de arquivos

A API Google Drive oferece o recurso Revisões para você fazer o download e publicar revisões de arquivos. Saiba mais sobre a terminologia de revisão em Visão geral das mudanças e revisões.

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

O Google Drive exclui automaticamente as revisões antigas que não são mais relevantes 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 limpe.

Fazer o download de uma revisão

É possível usar o valor do campo headRevisionId do recurso Files para fazer o download da revisão mais recente. Isso busca a revisão que corresponde aos metadados do arquivo recuperado anteriormente. Para fazer o download dos dados de todas as revisões anteriores do arquivo que ainda estão armazenadas na nuvem, chame revisions.list, que recebe todos os reviewIds.

Para fazer o download do conteúdo de revisão, é necessário chamar o método revisions.get com o parâmetro alt=media. Não é possível fazer o download de revisões de Documentos, Planilhas e Apresentações Google.

As revisões dos apps Documentos, Desenhos e Apresentações Google incrementam automaticamente os números de revisão. No entanto, uma série de números poderá apresentar lacunas se as revisões forem excluídas, portanto, não dependa de números sequenciais ao recuperar revisões.

Publicar uma revisão

Para publicar uma revisão do Documentos, do Planilhas e do Apresentações Google, defina a propriedade published do arquivo na propriedade Revisões. Não é possível definir esta propriedade para revisões do Google Sites com a API Drive.

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

As revisões publicadas não refletem as mudanças feitas em um arquivo, a menos que a propriedade publishAuto esteja definida. Se essa propriedade for definida como verdadeira, 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 Google Sites, publishAuto é sempre false.