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
.