Conectar o Google Drive
O KeepGlide para desktop é grátis para Linux (x86_64). Windows, macOS e Android estão em produção. As licenças pagas ainda não estão abertas. A configuração tem duas partes: seis passos no console do Google Cloud e, depois, cinco passos no app. No modo Sync, suas notas em Markdown e seus PDFs ficam no seu Google Drive e em uma pasta deste computador, mantidos em sintonia; no modo Nuvem, ficam no seu Google Drive, e este computador mantém um cache de leitura. Por padrão, uma nota editada nos dois lados é mesclada numa só nota; quando as edições se sobrepõem, ou o arquivo não é uma nota, o app guarda as duas versões e a outra vai para uma pasta _conflicts.
O modo Local não precisa de conta alguma. Se você quer apenas seus arquivos neste computador, escolha Só pasta local e pode pular o resto desta página.
Os cinco passos em 16 segundos. Desenhos simplificados, não gravações de tela. (legendas em inglês)
Escolha um modo
Cada computador escolhe o próprio modo em Configurações > Esta máquina e o vault, então um computador pode sincronizar enquanto outro continua local.
O modo Local é grátis. Quando as licenças pagas abrirem, a licença passa a incluir Sync e Nuvem: US$ 19, pagamento único. Sem licença, as Configurações oferecem só o modo Local.
Nuvem (“Tudo na nuvem”)
Notas e PDFs ficam no seu Google Drive. O app lê e grava tudo lá e guarda neste computador um cache de leitura e, para PDFs, as edições ainda não enviadas. Este modo precisa da conexão com o Google Drive.
Sync (“Sincronizar numa pasta local”)
Os arquivos ficam em uma pasta deste computador e no seu Google Drive, e as mudanças são levadas de um lado para o outro. Mudanças feitas sem conexão ficam neste computador e são enviadas quando a conexão voltar.
Local (“Só pasta local”)
Os arquivos ficam neste computador. Sem conta, sem rede e sem configuração do Google Drive.
Com uma licença, a configuração inicial oferece as mesmas três opções com os nomes Só pasta local, Google Drive e Pasta local e Drive.
Antes de começar
O KeepGlide para desktop roda no seu computador e não tem serviço de nuvem do KeepGlide; suas notas vão apenas para o seu próprio Google Drive, por isso o app pede que você crie uma conexão própria, uma única vez, no console do Google Cloud.
Crie ali um cliente do tipo App para computador (Desktop app) e baixe o arquivo JSON dele. Os nomes e as posições no console podem mudar; procure estes rótulos, que podem aparecer em inglês conforme o idioma da sua conta.
- Crie um projeto, por exemplo com o nome KeepGlide, e confirme que ele está selecionado.
- Ative a Google Drive API desse projeto com Ativar. Isso liga a API; sozinha, ela não dá acesso aos seus arquivos.
- Configure a tela de consentimento: um nome para o app, um e-mail de suporte e o público Externo para uma conta pessoal.
- Em Acesso a dados, adicione o escopo do Google Drive do nível de acesso que você vai usar e salve:
.../auth/drivepara Acesso total (padrão) ou.../auth/drive.filepara Acesso restrito (veja O que o app pode acessar). O app não pede acesso ao e-mail. - Para uso pessoal contínuo, selecione Publicar app e confirme Em produção. Se o app ficar Em teste, só as contas listadas em Usuários de teste conseguem conectar, então inclua ali a sua própria Conta do Google, e a autorização expira em 7 dias (veja Solução de problemas).
- Em Clientes, selecione Criar cliente, escolha App para computador e baixe o arquivo JSON quando ele for criado. Mantenha-o privado. Clientes de aplicativo da Web são recusados.
Conecte em cinco passos
As ilustrações mostram a versão das Configurações. A configuração inicial faz as mesmas perguntas, com os próprios botões. Nas Configurações, a seção do Google Drive também oferece Abrir o guia passo a passo, que abre o tutorial do próprio app em uma aba.
-
Importar o JSON do cliente
Em Configurações > Esta máquina e o vault, escolha Sync ou Nuvem para que a seção do Google Drive apareça. Depois, selecione Importar JSON do cliente e escolha o arquivo do App para computador que você baixou. Na configuração inicial, o botão se chama Importar JSON. Importar ainda não conecta a sua conta.
-
Conectar o Google Drive
Selecione Conectar Google Drive. A autorização abre no navegador padrão, e o app espera aqui: Conclua a autorização no navegador e volte a esta janela.
Se aparecer um aviso, confira o nome e as permissões do seu próprio projeto antes de continuar.
-
Permitir o acesso no navegador
Escolha a conta cujos arquivos do Google Drive guardam o seu cofre. Se o navegador mostrar que o app não foi verificado, continue por Avançado somente se o projeto for o que você criou; publicar o seu próprio projeto não remove esse aviso.
Revise a permissão de acesso aos arquivos do Google Drive e permita. Depois, o navegador volta para o app.
-
Testar a conexão
De volta ao app, selecione Testar conexão. Quando o teste passar, você verá Conexão testada. O Google Drive está pronto.
Se a permissão não tiver sido concedida, o app avisa e oferece Reconectar e permitir o Drive.
-
Escolher a pasta no Google Drive
Quando o teste passar, selecione Escolher no Drive…, escolha a pasta do cofre no seletor e confirme com Usar esta pasta. Na configuração inicial, o botão se chama Escolher pasta no Drive e, se o teste ainda não passou, o app pede que você teste a conexão antes.
No modo Sync, escolha também a pasta deste computador com Escolher pasta…. Em qualquer modo, selecione Aplicar nesta máquina para salvar o modo. Na configuração inicial, os botões se chamam Escolher pasta local e, depois, Ver atalhos para seguir, e o modo é salvo quando você seleciona Começar a usar, no fim.
O que o app pode acessar
O app pede apenas acesso aos arquivos do Google Drive. Ele nunca pede acesso à sua caixa de e-mail. Sua senha do Google nunca passa pelo app: você entra na própria página do Google.
Acesso total (padrão)
O app pode ver todos os seus arquivos do Google Drive, então o seletor de pastas consegue listar as pastas que você já tem.
Acesso restrito (opcional)
O app vê somente os arquivos que ele cria ou abre. Em contrapartida, o seletor de pastas deixa de listar pastas que o app não usou. O nível de acesso é uma opção avançada: a chave drive_scope do arquivo de configuração do app, keepglide.json. Não é um controle das Configurações; ao mudá-lo, o app pede que você permita o acesso de novo.
A autorização salva fica neste computador. Desconectar a remove.
Trabalhar offline
O comportamento do app sem conexão depende do modo escolhido.
Nuvem (“Tudo na nuvem”)
Leituras e gravações vão direto para o Google Drive, então este modo precisa da conexão. Este computador mantém um cache de leitura, e as edições de PDF que ainda não foram enviadas aguardam em um cache pendente até o envio ser confirmado.
Sync (“Sincronizar numa pasta local”)
Funciona offline. As mudanças esperam numa fila neste computador e são enviadas quando a conexão voltar.
Local (“Só pasta local”)
Não precisa de rede, porque nenhuma conta está envolvida.
Desconectar
Em Configurações, na seção do Google Drive, selecione Desconectar. O app pede confirmação: Remover o acesso ao Google Drive deste app nesta máquina? Quando terminar, ele mostra Desconectado.
Desconectar remove a autorização salva somente nesta máquina. Seus arquivos no Google Drive não são apagados. Para revogar o acesso do app em todos os lugares, use a página de conexões de terceiros da sua Conta do Google.
Solução de problemas
A conexão deixa de funcionar após 7 dias
Apps com o status de publicação em teste (Testing) recebem tokens de atualização que expiram em sete dias (documentação de OAuth do Google). Para uso pessoal contínuo, publique seu app no console do Google Cloud (Publicar app, depois Em produção) e selecione Conectar Google Drive para obter uma nova autorização. Publicar evita a expiração do modo de teste, mas não garante tokens permanentes e não verifica o app, então o aviso ainda pode aparecer.
O app diz que a permissão não foi concedida
Voltar ao app sem a permissão de acesso ao Google Drive deixa a conexão incompleta. Selecione Reconectar e permitir o Drive, permita o acesso no navegador e depois execute Testar conexão de novo.
O app recusa meu arquivo de cliente
O app aceita somente clientes do tipo App para computador; um cliente de aplicativo da Web é recusado. Crie um cliente do tipo App para computador no console do Google Cloud, baixe o JSON quando ele for criado e importe esse arquivo. Se o arquivo baixado não tiver a chave secreta do cliente, crie um novo cliente App para computador e baixe esse.
O teste de conexão falha
Verifique se a Google Drive API está ativada no projeto que contém o seu cliente e se este computador está online. Depois, execute Testar conexão de novo.
Mais sobre o app: KeepGlide para desktop · Entre na lista de espera