Um backup completo começa com tudo o que a API entrega

Toda ferramenta diz que é completa, e nenhuma consegue ser completamente. O NotionManager faz três coisas: pega tudo o que a API entrega, reconstrói a estrutura entre as partes e diz os limites com exatidão.

Ler tudo o que a API entrega

A primeira metade é ler tudo e não interpretar nada: cada raiz que você compartilhou, cada página, cada banco de dados, cada propriedade, cada bloco, descendo pelas páginas filhas até não sobrar nada. A cópia começa como matéria-prima. O que você filtrar ou remodelar nesta etapa não volta depois.

A menos que você peça um filtro, como pular comentários ou não baixar arquivos, o NotionManager tenta buscar tudo o que pode para que o backup local fique completo. A renderização final pode mudar por diferenças de estilo, mas os dados em si são sempre completos e confiáveis.

Depois, reconstruir o que os dados brutos significam

A segunda metade devolve a estrutura. O Notion é uma árvore e também um grafo. Páginas apontam umas para as outras por menções e relações, rollups calculam valores sobre essas relações, e bancos de dados são lidos por views que selecionam e ordenam suas linhas. Uma pasta cheia de JSON mantém os mesmos bytes, mas perde todo esse significado.

Reconstruir as relações deixa a cópia navegável e auditável. Você segue uma relação até a página que ela nomeia. Vê um rollup como o valor que ele tinha, não como uma fórmula que não resolve mais. Abre um banco de dados e lê as linhas que a view mostrava.

O que a reconstrução cobre

  • Estrutura da página

    A estrutura completa da página, com renderização para todo tipo de bloco compatível, como rich text e callouts.

  • Referências entre páginas

    Quando uma página menciona outra, esse link fica dentro da cópia. Segui-lo funciona offline.

  • Relações de banco de dados

    Quando uma linha aponta para uma linha de outro banco de dados, a cópia mantém isso como uma relação entre as páginas copiadas, não como um identificador solto.

  • Rollups

    Os valores calculados são guardados como os valores que tinham no momento da execução. Uma cópia histórica deve mostrar os valores daquele momento.

  • Views

    Cada view é copiada junto com os dados que apresenta: as linhas, suas propriedades e a ordem que a view deu a elas.

  • Arquivos de mídia externos

    Imagens, vídeos, áudio e PDFs, exatamente como aparecem no Notion.

A lista, dita com clareza

Parte de um workspaceEstá no backup?
Páginas, seus blocos e seu aninhamentoSim. Lidas até a última página filha.
Bancos de dados, suas fontes de dados e propriedadesSim, incluindo as propriedades que cada linha carrega.
Linhas como páginasSim. Cada linha é uma página com conteúdo próprio.
Relações e menções entre páginasSim. Reconstruídas para que os links funcionem dentro da cópia.
Rollups e outros valores calculadosSim. Guardados como os valores que tinham quando a execução aconteceu.
As linhas e a ordem por trás de cada viewSim. Os dados que a view apresentava.
A aparência de uma view: cores, agrupamento, layoutEm parte. A API não devolve tudo, e a cópia segue os estilos do Notion o mais perto que consegue.
ComentáriosEm parte. Apenas comentários não resolvidos são copiados. Copiar comentários exige um interruptor próprio, porque deixa o backup muito mais lento.
Arquivos de mídia externosSim. Por padrão, todo arquivo de mídia externo é baixado localmente, para a melhor leitura offline. Se preferir, você pode desativar o download.
Tipos de bloco que a API não descreveEm parte. Mantidos com o tipo e a posição declarados, com uma marca clara na página, para você ver onde faltam dados.
Permissões do workspace, compartilhamento e acesso de convidadosNão. Isso é configuração do Notion, não conteúdo.
Tudo o que você não compartilhou com a integraçãoNão. A cópia contém exatamente o que você autorizou.

Por que a lista é curta e honesta

Uma ferramenta de backup que diz guardar tudo não olhou a API de perto. A lista acima mostra o que a API do Notion pode dar a qualquer pessoa. As três últimas linhas são as que mais importam: são o motivo de um backup somar ao Notion em vez de substituí-lo.

O teste útil não é se a cópia é completa em teoria. É se você consegue abri-la e conferir por conta própria. A cópia navegável existe para isso.

A boa notícia é que, como usuário, tudo o que você vê no Notion pode ser copiado. O que não pode costuma ser estilo e estruturas especiais, e nada disso afeta o valor ou a validade do backup.

Confira a sua própria cópia

Faça um backup, abra offline e siga uma ou duas relações. O que você encontrar deve bater com a lista acima.

Para onde ir agora

Perguntas frequentes

Um backup completo inclui os arquivos anexados?

Arquivos fazem parte do conteúdo. Sempre que a API os oferece, o NotionManager os lê, inclusive arquivos atrás de um link externo. Alguns links de arquivo são emitidos só temporariamente e depois param de funcionar, então o NotionManager prefere baixar todos os arquivos localmente. Você ainda controla esse comportamento.

Por que as cores e os layouts das views não são copiados?

Porque o Notion não oferece nenhuma interface que os devolva. O NotionManager restaura os estilos da view o mais perto que consegue, mas não promete ficar idêntico ao Notion.

Se os rollups são guardados como valores, eles ficam errados depois de restaurar?

Eles estão certos para o momento em que a cópia foi feita. Uma cópia histórica deve mostrar o que o workspace dizia então, não o que uma fórmula diria agora.

“Completo” é o mesmo que “tudo”?

Não. Nenhum backup do Notion pode afirmar isso com honestidade. Completo significa tudo o que a API entrega, estruturado do jeito que o Notion estrutura, com as partes que a API recusa ditas abertamente.