Parte 1 de 3
☁️ Guia de configuração

Backup no
Google Drive

Configure o backup automático dos seus dados financeiros em menos de 15 minutos. Gratuito, seguro e sem intermediários.

⏱️ ~15 minutos 🆓 Gratuito 🔒 Seus dados, sua conta
💡 Como funciona: o Granzo salva seus dados diretamente na sua conta Google Drive — numa pasta privada que só o app consegue acessar. Nenhum servidor do Granzo toca nos seus dados.
1

Google Cloud Console

Criar o projeto e ativar a API — feito uma única vez

1

Acesse o Google Cloud Console

Abra console.cloud.google.com e faça login com a sua conta Google (pode ser a mesma do Gmail).

2

Crie um novo projeto

No topo da página, ao lado do logo "Google Cloud", clique no seletor de projeto → Novo Projeto.
Nome: Granzo (pode ser qualquer nome). Clique em Criar e depois Selecionar para ativá-lo.

3

Ative a Google Drive API

No menu lateral (☰) → APIs e Serviços → Biblioteca.
Busque por Google Drive API, clique no resultado e clique em Ativar.

4

Configure a Tela de Consentimento OAuth

Menu lateral (☰) → APIs e Serviços → Tela de consentimento OAuth.
Selecione tipo Externo → Criar. Preencha:

  • Nome do app: Granzo
  • E-mail de suporte: seu e-mail
  • Clique em Salvar e Continuar em todas as telas seguintes
  • Em Usuários de teste → adicione seu e-mail
⚠️ O app ficará em modo "Em teste" — isso é suficiente para uso pessoal. Você pode adicionar até 100 e-mails de usuários de teste.
2

Criar o Client ID OAuth

A credencial que identifica o Granzo para o Google

5

Crie as credenciais

Menu lateral (☰) → APIs e Serviços → Credenciais.
Clique em + Criar Credenciais → ID do cliente OAuth.

6

Selecione "Aplicativo da Web"

Na lista de tipos, selecione Aplicativo da Web.

🚫 Não selecione "Android"! Mesmo o Granzo sendo um app Android, o backup funciona via WebView — que se comporta como um navegador. A opção "Android" vai pedir SHA-1 fingerprint e não vai funcionar.
7

Adicione as origens autorizadas

Em Origens JavaScript autorizadas, adicione as URLs de acordo com o que você usa:

SituaçãoURI para adicionar
App Android (APK / Play Store)https://localhostobrigatório
Site granzo.apphttps://granzo.appobrigatório
Desenvolvimento local (PC)http://localhost:5173opcional
GitHub Pageshttps://lucas2003-18.github.ioopcional

Adicione pelo menos as duas marcadas como obrigatório. Depois clique em Criar.

💡 O https://localhost é necessário porque o app Android roda num WebView que usa essa origem internamente. Sem ele, o backup não vai funcionar no APK.
8

Copie o Client ID

Uma janela vai mostrar o ID do cliente — copie esse valor. Ele termina com .apps.googleusercontent.com.

✅ O Client ID não é secreto — pode ficar visível no código. Guarde-o nas suas anotações para caso precise reinstalar o app.
3

Configurar no Granzo

Conectar e fazer o primeiro backup

9

Cole o Client ID no app

Abra o Granzo → ⚙️ Config → ☁️ Drive → toque em Configurar Client ID.
Cole o ID que você copiou e salve.

10

Conecte sua conta Google

Toque em Conectar Google Drive. Uma janela de login do Google vai abrir.
Ao ver "App não verificado" → clique em Avançado → Acessar Granzo (não seguro) → Permitir.

⚠️ O aviso "App não verificado" aparece porque o projeto está em modo de teste no Google — você mesmo criou as credenciais, então é seguro prosseguir.
11

Faça o primeiro backup 🎉

Toque em Salvar backup agora. Aguarde a mensagem "✓ Backup salvo no Google Drive!".
Pronto — seus dados estão seguros na nuvem.

📋 Resumo dos passos

1–4
Google Cloud ConsoleCriar projeto, ativar Drive API, configurar OAuth
5–8
Client ID OAuthTipo "Aplicativo da Web", adicionar origens, copiar ID
9
Colar no Granzo⚙️ Config → ☁️ Drive
10
Conectar GoogleLogin + autorizar acesso
11
Primeiro backupSalvar e confirmar
?

Perguntas frequentes

Meus dados financeiros ficam seguros?
Sim. O arquivo é salvo na appDataFolder — uma pasta privada e invisível no seu Drive. Não aparece na listagem normal de arquivos e só o Granzo consegue acessar. Nenhum servidor do Granzo recebe seus dados.
Por que selecionar "Aplicativo da Web" e não "Android"?
O Granzo usa um WebView internamente — é como um navegador embutido no app. O fluxo de login OAuth funciona via web, não pelo SDK nativo do Android. Se selecionar "Android", o Google vai pedir SHA-1 fingerprint e o backup não vai funcionar.
A janela de login não abre / popup bloqueado
O navegador bloqueou o popup. Procure o ícone de popup bloqueado na barra de endereço e permita para o Granzo. Em Android, verifique se o Chrome/WebView está atualizado.
"Sessão expirada — reconecte sua conta"
O token OAuth tem validade de ~1 hora. Basta tocar em Conectar Google Drive novamente. Não é necessário reconfigurar o Client ID.
Erro 400: redirect_uri_mismatch
A URL do seu app não foi adicionada nas origens autorizadas. Volte ao Google Cloud Console → Credenciais → edite o Client ID e adicione a URL exata. Para o APK Android, adicione https://localhost.
Posso usar o mesmo Client ID para outros usuários?
Sim, para uso entre amigos — adicione o e-mail de cada pessoa como usuário de teste no projeto (limite de 100 e-mails). Para uso aberto e público, será necessário verificar o app no Google.
Como restaurar um backup?
⚙️ Config → ☁️ Drive → Restaurar do Drive. O app mostra a data do backup e o número de lançamentos antes de confirmar. Atenção: restaurar substitui todos os dados atuais.
🚀

Pronto para começar?

Baixe o Granzo e configure o backup em 15 minutos.

▶ Baixar na Play Store
← Voltar ao início