A API Google Drive fornece o recurso Revisões 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 alterações e revisões.
Especificar revisões para salvar com a exclusão automática
O Google Drive exclui automaticamente revisões mais antigas que não são mais de interesse do usuário. Para evitar que isso aconteça, defina a sinalização 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 da revisão, chame o método
revisions.get com o parâmetro alt=media. Não é possível fazer o download das revisões de arquivos dos apps Documentos, Planilhas e Apresentações Google.
Os arquivos dos Documentos, dos Desenhos e das Apresentações Google são incrementados automaticamente. No entanto, a série de números poderá ter lacunas se as revisões forem excluídas. Portanto, não confie em números sequenciais ao recuperar revisões.
Publicar uma revisão
Para publicar uma revisão do Documentos, Planilhas e Apresentações Google, defina a propriedade published desse arquivo na propriedade Revisões. Não é possível definir essa propriedade para revisões do Google Sites pela API Drive.
Se o arquivo for criado em um domínio Google Workspace ,
a propriedade publishedOutsideDomain indica se a revisão é
acessível a qualquer pessoa ou se ela é restrita aos usuários do domínio. Para arquivos
do Google 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 a 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 IU do Drive. Para arquivos do Google Sites, publishAuto é sempre false.