147 lines
5.1 KiB
Markdown
147 lines
5.1 KiB
Markdown
# 📁 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
|
|
|
|
1. Acesse [Google Cloud Console](https://console.cloud.google.com/)
|
|
2. Clique em **"Selecionar projeto"** → **"Novo projeto"**
|
|
3. Digite o nome: `Liberi Kids - Sistema`
|
|
4. Clique em **"Criar"**
|
|
|
|
### 2. Ativar Google Drive API
|
|
|
|
1. No menu lateral, vá em **"APIs e serviços"** → **"Biblioteca"**
|
|
2. Pesquise por **"Google Drive API"**
|
|
3. Clique na API e depois em **"Ativar"**
|
|
|
|
### 3. Criar Credenciais OAuth 2.0
|
|
|
|
1. Vá em **"APIs e serviços"** → **"Credenciais"**
|
|
2. Clique em **"+ Criar credenciais"** → **"ID do cliente OAuth"**
|
|
3. Selecione **"Aplicação da Web"**
|
|
4. Configure:
|
|
- **Nome:** `Liberi Kids Sistema`
|
|
- **URIs de redirecionamento autorizados:**
|
|
```
|
|
http://localhost:5000/auth/google-drive/callback
|
|
```
|
|
5. Clique em **"Criar"**
|
|
6. **Copie o Client ID e Client Secret** que aparecerão
|
|
|
|
### 4. Configurar no Sistema
|
|
|
|
1. Acesse **Configurações** no sistema Liberi Kids
|
|
2. Encontre a seção **"📁 Google Drive - Armazenamento de Fotos"**
|
|
3. Clique para expandir
|
|
4. Cole as credenciais:
|
|
- **Client ID:** Cole o ID copiado do Google Cloud
|
|
- **Client Secret:** Cole o Secret copiado do Google Cloud
|
|
5. Clique em **"Salvar Credenciais"**
|
|
|
|
### 5. Autorizar Acesso
|
|
|
|
1. Após salvar, clique em **"Autorizar Google Drive"**
|
|
2. Uma nova janela abrirá com a tela de login do Google
|
|
3. Faça login com sua conta Google
|
|
4. Autorize o acesso aos arquivos do Google Drive
|
|
5. A janela fechará automaticamente
|
|
6. 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
|
|
|
|
1. **Conta Google:** Use uma conta Google com espaço suficiente
|
|
2. **Backup Local:** O sistema mantém fallback para armazenamento local
|
|
3. **Compatibilidade:** Funciona com produtos existentes
|
|
4. **Performance:** Upload pode ser mais lento que armazenamento local
|
|
5. **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.
|