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 do 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
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 "Reproduzir automaticamente quando houver alterações" na interface do Drive. Slides e
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
.