Neste guia, explicamos como usar o recurso revisions
para gerenciar revisões de arquivos, como receber uma revisão de arquivo e
publicar uma revisão do Google Workspace. A API Google Drive também permite
baixar revisões. Para mais detalhes sobre a terminologia de revisão, consulte Visão geral de mudanças e revisões.
Para acessar o histórico de revisões, um usuário precisa ter o role de owner, organizer, fileOrganizer ou writer.
Para especificar os campos a serem retornados na resposta, defina o parâmetro do sistema fields com qualquer método do recurso revisions. Se você omitir o parâmetro, o servidor vai retornar um conjunto padrão de campos. Por exemplo, o método revisions.list retorna apenas os campos id, mimeType, kind e modifiedTime. Para retornar campos diferentes, consulte Retornar campos específicos.
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 do usuário.
Uma revisão de arquivo blob pode ser definida como "Manter para sempre", o que significa que ela não pode ser excluída automaticamente. Até 200 revisões podem ser definidas como "Manter para sempre" e contam para o limite de armazenamento. A revisão principal nunca é excluída automaticamente.
Qualquer revisão de arquivo blob, exceto a revisão principal, que não seja designada como "Manter indefinidamente" pode ser excluída. As revisões passíveis de exclusão são preservadas por 30 dias, mas podem ser excluídas antes se um arquivo tiver 100 revisões que não estão designadas como "Manter para sempre" e uma nova revisão for enviada.
Defina o campo booleano keepForever do recurso revisions como true para marcar as revisões que você
não quer que o Drive exclua. Depois que uma revisão de arquivo blob é definida como "Manter para sempre", ela só pode ser baixada ou excluída. Para mais informações, consulte
Fazer o download de uma revisão ou Excluir uma
revisão.
Se você estiver usando a API Drive v2 mais antiga, use o campo pinned do recurso
revisions em vez de
keepForever.
Acessar uma revisão de arquivo
Para receber os metadados ou o conteúdo de uma revisão de arquivo, use o método get no recurso
revisions com os parâmetros de caminho fileId e
revisionId. Se você não souber o ID da revisão, liste
todas as revisões de um arquivo usando o método list.
O método retorna os metadados da revisão como uma instância de um recurso revisions.
Para reconhecer o risco de baixar malware conhecido ou outros arquivos abusivos, defina o parâmetro de consulta acknowledgeAbuse como true. Esse campo só é aplicável quando o parâmetro alt=media está definido e o usuário é o proprietário do arquivo ou um organizador do drive compartilhado em que o arquivo está.
Listar as revisões de um arquivo
Para listar as revisões de um arquivo, use o método list
no recurso revisions com o
parâmetro de caminho fileId. O método retorna uma lista de revisões de arquivos.
Transmita os seguintes parâmetros de consulta para personalizar a paginação ou filtrar revisões:
pageSize: o número máximo de revisões a serem retornadas por página.pageToken: um token de página recebido de uma chamada de lista anterior. Informe esse token para recuperar a página subsequente.
Atualizar uma revisão de arquivo
Para atualizar uma revisão em um arquivo, use o método
update no recurso revisions com os parâmetros de caminho fileId e revisionId.
O método retorna uma instância de um recurso revisions.
Baixar uma revisão
Só é possível baixar revisões de conteúdo de arquivos blob marcadas como "Manter indefinidamente". Se quiser baixar uma revisão, defina-a como "Manter indefinidamente" primeiro. Para mais informações, consulte Especificar revisões para salvar da exclusão automática.
Para baixar uma revisão de conteúdo de arquivo blob ou exportar uma revisão de conteúdo de documento do Google Workspace, consulte Baixar e exportar arquivos.
Excluir uma revisão de arquivo
Para excluir permanentemente uma revisão de arquivo, use o método
delete no recurso revisions com os parâmetros de caminho fileId e revisionId.
Só é possível excluir revisões de arquivos blob com conteúdo binário no Drive, como imagens, vídeos e PDFs. É possível excluir uma revisão de arquivo blob quando ela está marcada como "Manter indefinidamente". Não é possível excluir revisões de outros arquivos, como Documentos ou Planilhas Google, e a última revisão restante do arquivo binário.
Publicar uma revisão
Para publicar uma revisão dos Documentos, das Planilhas e das Apresentações Google, defina a propriedade published desse arquivo no recurso revisions. Essa propriedade não pode ser definida para revisões do Google Sites usando a API Drive.
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 estiver definida como true, as revisões mais recentes de um arquivo serão publicadas automaticamente, substituindo as anteriores.
O Apresentações e o Desenhos Google só oferecem suporte à republicação automática e exigem que a propriedade publishAuto seja definida como true. Para arquivos do
Sites, publishAuto é sempre false.
Se o arquivo for criado em um domínio do Google Workspace, a propriedade
publishedOutsideDomain vai indicar se a revisão está acessível
para qualquer pessoa ou se ela está restrita aos usuários do domínio. Para arquivos do Sites, essa propriedade indica se uma permissão type=anyone existe. Para mais informações, consulte o campo type no recurso permissions.
A publicação automática também é controlada pela caixa de seleção "Republicar automaticamente quando houver alterações" na interface dos Documentos e das Planilhas Google. Para mais informações, consulte Tornar público um arquivo dos Documentos, Planilhas, Apresentações e Formulários Google.