A API Google Drive oferece o recurso Revisões para você 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 a serem salvas usando a exclusão automática
O Google Drive exclui automaticamente as revisões mais 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 armazenados na nuvem, chame revisions.list, que recebe todos os reviewIds.
Para fazer o download do conteúdo de revisão, você precisa chamar
Método revisions.get com o parâmetro alt=media. Não é possível fazer o download de revisões dos apps Documentos, Planilhas e Apresentações Google.
As revisões dos apps Documentos, Desenhos e Apresentações incrementam automaticamente os números de revisão. No entanto, séries de números podem 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 dos apps Documentos, Planilhas e 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 usando a API Drive.
Se o arquivo for criado em um Google Workspace domínio,
a propriedade publishedOutsideDomain indica se a revisão é
acessível por qualquer pessoa ou se for restrito aos usuários do domínio. Para o Google
Sites, esta propriedade indica se a 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 verdadeira, as revisões mais recentes de um arquivo serão publicadas automaticamente, substituindo as anteriores. Esse comportamento também é controlado pela opção "Republicar automaticamente quando houver alterações" na interface do Google Drive. Para arquivos do Google Sites, publishAuto é sempre false.