5.1 KiB
5.1 KiB
📁 Google Drive Integration - Guia de Configuração
Este guia explica como configurar a integração com Google Drive para armazenar as fotos dos produtos automaticamente na nuvem.
🎯 Benefícios da Integração
- ☁️ Armazenamento na Nuvem: Fotos salvas automaticamente no Google Drive
- 🔒 Backup Seguro: Suas imagens ficam protegidas na nuvem do Google
- 📱 Acesso Universal: Visualize as fotos de qualquer dispositivo
- 💾 Economia de Espaço: Não ocupa espaço no servidor local
- 🔗 URLs Públicas: Links diretos para visualização das imagens
🚀 Configuração Passo a Passo
1. Criar Projeto no Google Cloud Console
- Acesse Google Cloud Console
- Clique em "Selecionar projeto" → "Novo projeto"
- Digite o nome:
Liberi Kids - Sistema - Clique em "Criar"
2. Ativar Google Drive API
- No menu lateral, vá em "APIs e serviços" → "Biblioteca"
- Pesquise por "Google Drive API"
- Clique na API e depois em "Ativar"
3. Criar Credenciais OAuth 2.0
- Vá em "APIs e serviços" → "Credenciais"
- Clique em "+ Criar credenciais" → "ID do cliente OAuth"
- Selecione "Aplicação da Web"
- Configure:
- Nome:
Liberi Kids Sistema - URIs de redirecionamento autorizados:
http://localhost:5000/auth/google-drive/callback
- Nome:
- Clique em "Criar"
- Copie o Client ID e Client Secret que aparecerão
4. Configurar no Sistema
- Acesse Configurações no sistema Liberi Kids
- Encontre a seção "📁 Google Drive - Armazenamento de Fotos"
- Clique para expandir
- Cole as credenciais:
- Client ID: Cole o ID copiado do Google Cloud
- Client Secret: Cole o Secret copiado do Google Cloud
- Clique em "Salvar Credenciais"
5. Autorizar Acesso
- Após salvar, clique em "Autorizar Google Drive"
- Uma nova janela abrirá com a tela de login do Google
- Faça login com sua conta Google
- Autorize o acesso aos arquivos do Google Drive
- A janela fechará automaticamente
- Verifique se o status mudou para "✅ Conectado"
📋 Como Funciona
Upload Automático
- Quando você cadastra um produto com fotos, o sistema detecta automaticamente se o Google Drive está configurado
- Se estiver conectado, as fotos são enviadas para a pasta "Liberi Kids - Fotos Produtos"
- Caso contrário, usa o armazenamento local como antes
Organização das Fotos
- Pasta Principal:
Liberi Kids - Fotos Produtos - Nome dos Arquivos:
Marca_NomeProduto_Tamanho_Cor_Timestamp.jpg - Exemplo:
Nike_Camiseta_M_Azul_1641234567890.jpg
URLs Públicas
- Cada foto recebe uma URL pública do Google Drive
- As URLs são salvas no banco de dados
- As imagens são exibidas normalmente no sistema
🔧 Configurações Avançadas
Informações de Armazenamento
O sistema mostra:
- Espaço Usado: Quanto você já utilizou
- Espaço Total: Limite da sua conta Google
- Espaço Livre: Quanto ainda pode usar
Renovação Automática
- Os tokens de acesso são renovados automaticamente
- Não é necessário reautorizar frequentemente
- O sistema mantém a conexão ativa
🛠️ Solução de Problemas
Erro: "Credenciais não configuradas"
- Verifique se copiou corretamente o Client ID e Client Secret
- Certifique-se de que ativou a Google Drive API
Erro: "Autorização pendente"
- Clique em "Autorizar Google Drive" novamente
- Verifique se não bloqueou pop-ups no navegador
Erro: "Erro de conexão"
- Clique em "Tentar Novamente"
- Se persistir, clique em "Reconfigurar Tudo"
Fotos não aparecem
- Verifique se as URLs começam com
https://drive.google.com/ - Teste se consegue acessar a pasta no Google Drive
📊 Monitoramento
Status da Conexão
- 🟢 Conectado: Tudo funcionando
- 🟡 Não configurado: Precisa configurar credenciais
- 🔵 Autorização pendente: Precisa autorizar acesso
- 🔴 Erro de conexão: Problema na conexão
Ações Disponíveis
- Atualizar Status: Verifica a conexão atual
- Abrir Google Drive: Acessa sua pasta no navegador
- Desconectar: Remove a integração
🔐 Segurança
Dados Protegidos
- Credenciais salvas criptografadas no Supabase
- Tokens renovados automaticamente
- Acesso limitado apenas às pastas necessárias
Permissões
O sistema solicita apenas:
- drive.file: Criar e gerenciar arquivos criados pelo app
- drive.readonly: Ler informações básicas do Drive
📝 Notas Importantes
- Conta Google: Use uma conta Google com espaço suficiente
- Backup Local: O sistema mantém fallback para armazenamento local
- Compatibilidade: Funciona com produtos existentes
- Performance: Upload pode ser mais lento que armazenamento local
- Dependência: Requer conexão com internet para upload
🎉 Pronto!
Após seguir todos os passos, suas fotos de produtos serão automaticamente salvas no Google Drive, proporcionando backup seguro e acesso universal às imagens do seu estoque.
Para dúvidas ou problemas, verifique os logs do sistema ou entre em contato com o suporte técnico.