⏱ Tiempo estimado: 22 minutos

🎯 Rama / Perfil: Developers y automatizadores técnicos

🧠 Conocimiento previo necesario: Haber visto cómo se usa Gemini dentro de Gmail/Sheets desde la interfaz (clases 1-6 del curso). No necesitas experiencia previa en Apps Script, pero sí saber leer JavaScript básico.

💡 ¿Qué vas a lograr? Un script que se dispara solo, llama a la API de Gemini (no al Gemini de la interfaz) y envía un correo redactado por IA cuando llega una fila nueva a tu hoja de cálculo.

🛠 Lo que necesitas antes de empezar

• Cuenta de Google (la misma que usas en Workspace) → Google Sheets
• Una API Key de Gemini → 🔗 Google AI Studio
• Editor de Apps Script (viene incluido en Sheets, no necesitas instalar nada) → 🔗 Google Apps Script

⚠️ Nota importante de seguridad: Google está migrando las API Keys de Gemini a "auth keys" restringidas — a partir de septiembre de 2026 las keys sin restricción dejarán de funcionar. Cuando crees tu key en AI Studio, restríngela a la "Generative Language API" desde el inicio para evitar sorpresas.

📋 Pasos

Paso 1 — Crea tu API Key en Google AI Studio

Entra a Google AI Studio, inicia sesión y haz clic en Create API key. Elige "crear en un proyecto nuevo" si es tu primera vez. Copia la key: la necesitarás en el paso 4. No la compartas ni la subas a ningún repositorio público.

Paso 2 — Prepara tu hoja de datos

Crea una hoja nueva en Google Sheets con estas columnas: Nombre, Correo, Consulta, Estado. Esta será la fuente de datos que Gemini va a leer y procesar automáticamente. Deja la primera fila como encabezado.

Paso 3 — Abre el editor de Apps Script

Desde tu hoja, ve a Extensiones → Apps Script. Se abrirá un editor en una pestaña nueva conectado directamente a tu hoja de cálculo — no necesitas instalar ningún software.

Paso 4 — Guarda tu API Key de forma segura

Nunca pegues la key directamente en el código. En el editor de Apps Script ve a Configuración del proyecto (ícono de engranaje) → Propiedades del script → Añadir propiedad de script, y guarda:

• Propiedad: GEMINI_API_KEY
• Valor: (pega tu key del paso 1)

Paso 5 — Escribe la función que llama a la API de Gemini

Vuelve a la pestaña de código y pega esto:

javascript

function procesarConsultaConGemini() {
  const apiKey = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
  const hoja = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Hoja 1');
  const datos = hoja.getDataRange().getValues();

  for (let i = 1; i < datos.length; i++) {
    const [nombre, correo, consulta, estado] = datos[i];
    if (estado === 'Pendiente') {
      const prompt = `Redacta una respuesta breve, profesional y amable en español ` +
        `para ${nombre}, que preguntó: "${consulta}". Máximo 4 líneas.`;

      const respuesta = UrlFetchApp.fetch(
        'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent',
        {
          method: 'post',
          contentType: 'application/json',
          headers: { 'x-goog-api-key': apiKey },
          payload: JSON.stringify({
            contents: [{ parts: [{ text: prompt }] }]
          })
        }
      );

      const json = JSON.parse(respuesta.getContentText());
      const textoGenerado = json.candidates[0].content.parts[0].text;

      GmailApp.sendEmail(correo, 'Respuesta a tu consulta', textoGenerado);
      hoja.getRange(i + 1, 4).setValue('Respondido');
    }
  }
}

Paso 6 — Prueba la función manualmente

Añade una fila de prueba en tu hoja con tu propio correo y Estado = Pendiente. En el editor de Apps Script, selecciona la función procesarConsultaConGemini y haz clic en Ejecutar. La primera vez te pedirá autorizar permisos (Gmail y hoja de cálculo) — acéptalos. Revisa tu bandeja de entrada: deberías recibir el correo generado por IA.

Paso 7 — Automatízalo con un activador (trigger)

En el editor de Apps Script, ve al ícono de reloj (Activadores) → Añadir activador. Configura: función procesarConsultaConGemini, evento "Basado en tiempo", cada 5 o 10 minutos. Desde ahora, cualquier fila nueva con Estado = Pendiente se procesará y responderá sola.

✅ Resultado esperado

Un flujo automatizado y funcional: cada vez que agregues una fila con una consulta pendiente en tu hoja, un script (no la interfaz de Gemini) generará una respuesta con la API, la enviará por Gmail y actualizará el estado — todo sin que tú lo dispares manualmente.

🔥 Tu reto (siguiente acción)

Reemplaza el trigger por tiempo por un trigger onFormSubmit, conectando un Google Form como puerta de entrada. Así cualquier persona de tu equipo podrá generar respuestas automáticas con IA simplemente llenando un formulario, sin tocar Sheets ni Apps Script.

📚 Recursos para ir más lejos

• Documentación oficial de la API de Gemini — Referencia completa de modelos, parámetros y límites.
• Documentación oficial de Google Apps Script — Para explorar más servicios (Calendar, Drive, Forms) que puedes combinar con la API.