# 🌐 GUÍA DE INTEGRACIÓN CON GOOGLE TRANSLATE API

## 📋 PASO 1: Crear Proyecto en Google Cloud

1. **Ve a Google Cloud Console**
   - URL: https://console.cloud.google.com/
   - Inicia sesión con tu cuenta de Google

2. **Crea un Proyecto Nuevo**
   - Haz clic en el selector de proyectos (arriba)
   - Click en "NEW PROJECT"
   - Nombre: `Enneagram Translations` (o el que prefieras)
   - Click en "CREATE"

## 🔑 PASO 2: Obtener API Key

1. **Habilita Cloud Translation API**
   - En el menú lateral, ve a: **APIs & Services** > **Library**
   - Busca: `Cloud Translation API`
   - Haz click en el resultado
   - Click en **ENABLE**

2. **Crear Credenciales (API Key)**
   - Ve a: **APIs & Services** > **Credentials**
   - Click en **+ CREATE CREDENTIALS**
   - Selecciona **API Key**
   - Se generará tu API Key
   - **¡COPIA Y GUARDA TU API KEY!**

3. **Restringir API Key (Recomendado)**
   - Click en **EDIT API KEY** (ícono de lápiz)
   - En **API restrictions**:
     - Selecciona "Restrict key"
     - Marca solo: **Cloud Translation API**
   - Click en **SAVE**

## 💰 PASO 3: Configurar Facturación (IMPORTANTE)

Google Translate API **NO ES GRATIS**, pero tiene:
- **GRATIS**: Primeros $300 en créditos (válidos 90 días)
- **PRECIO**: $20 USD por cada millón de caracteres

**Para tu caso:**
- Tienes ~91 registros
- Estimado: ~100,000 caracteres total
- **Costo aproximado: $2 USD** (usando créditos gratis)

**Configurar facturación:**
1. Ve a: **Billing** en el menú lateral
2. Click en **Link a billing account**
3. Agrega tarjeta de crédito (necesario aunque uses créditos gratis)

## 🚀 PASO 4: Usar el Script

1. **Edita el script**
   ```bash
   notepad C:\xampp4\htdocs\eneagrama_api\reportes\funciones_php\translate_with_google_api.php
   ```

2. **Reemplaza tu API Key** (línea 11)
   ```php
   $GOOGLE_API_KEY = 'TU_API_KEY_AQUI'; // ← Pega tu API Key aquí
   ```

3. **Ejecuta el script**
   ```bash
   cd C:\xampp4\htdocs\eneagrama_api\reportes\funciones_php
   php translate_with_google_api.php
   ```

## ✅ PASO 5: Verificar Resultados

Después de ejecutar, verifica:
1. Abre tu aplicación React
2. Ve a Results Page
3. Cambia idioma a English
4. ¡Verás traducciones profesionales!

## 🔍 Prueba Simple (Test Script)

Antes de traducir todo, prueba con este comando:

```bash
php test_google_api.php
```

Esto traducirá solo 1 registro como prueba.

## ⚠️ NOTAS IMPORTANTES

### Límites de la API:
- **Gratis**: $300 de crédito (válidos 90 días)
- **Rate limit**: 1,000 requests/minuto
- **Caracteres**: No hay límite si tienes crédito

### Seguridad:
- **NO COMPARTAS** tu API Key públicamente
- **NO LA SUBAS** a GitHub
- Usa restricciones de API para seguridad

### Troubleshooting:

**Error: "API key not valid"**
- Verifica que copiaste bien la key
- Asegúrate de habilitar Cloud Translation API

**Error: "Billing not enabled"**
- Activa facturación en Google Cloud Console
- Aunque sea gratis, necesitas vincular tarjeta

**Error: "Quota exceeded"**
- Espera unos minutos
- Verifica límites en Google Cloud Console

## 📞 SOPORTE

- **Documentación oficial**: https://cloud.google.com/translate/docs
- **Precios**: https://cloud.google.com/translate/pricing
- **Console**: https://console.cloud.google.com/

---

## 🎯 ALTERNATIVA: DeepL API (Opcional)

Si prefieres DeepL (mejor calidad para español):

1. **Registro**: https://www.deepl.com/pro-api
2. **Plan FREE**: 500,000 caracteres/mes GRATIS
3. **Mejor calidad** de traducción que Google para ES→EN

¿Quieres que te ayude a integrar DeepL en su lugar?
