Saltar al contenido
Automatización y agentes

Guardar los adjuntos de Gmail en Google Drive automáticamente: una carpeta que se llena sola, con Apps Script

Actualizado el 10 min de lectura

Lo esencial

  • Un programa de Apps Script busca en tu Gmail los correos con adjuntos que cumplen tu búsqueda (por ejemplo, `label:facturas`) y guarda cada archivo en una carpeta de Google Drive, con la fecha del correo delante del nombre.
  • No repite: recuerda qué correos ya revisó. Un disparador lo ejecuta cada hora, aunque no tengas nada abierto.
  • Puedes quedarte solo con algunos tipos de archivo (por ejemplo, PDF y XML), y las imágenes de las firmas no se guardan.
  • Empieza en modo de ensayo: no toca Drive, solo escribe en el registro qué archivos guardaría.
  • Gratis con una cuenta de Google. Ojo: pide permisos amplios sobre tu Gmail y tu Drive. Nivel principiante, unos 20 minutos. Probado con una simulación; nadie lo ejecutó aún en una cuenta real.

Las facturas, los extractos del banco, los trabajos de tus alumnos: llegan como adjuntos y se quedan enterrados en el correo. Esta guía deja un programa corto de Apps Script que hace ese trabajo por ti: revisa tu Gmail cada hora y guarda en una carpeta de Google Drive los adjuntos de los correos que tú elijas, con la fecha delante para que se ordenen solos.

Qué necesitas

  • Una cuenta de Google con Gmail y Google Drive, y un navegador en el computador.
  • Nivel: principiante. Vas a copiar un programa, cambiar una o dos líneas y autorizarlo una vez. No hace falta saber programar.
  • Tiempo: unos 20 minutos la primera vez.
  • Dinero: nada. Apps Script se usa gratis con tu cuenta de Google, con cuotas (leídas dos veces el 15 de noviembre de 2026). Con una cuenta personal: 20.000 lecturas o escrituras de correo al día, 6 minutos por ejecución, 90 minutos al día de disparadores y 50.000 lecturas o escrituras de la memoria del programa (el servicio de propiedades) al día. Con Google Workspace los límites son mayores y están en la misma página. Los archivos ocupan espacio de tu cuenta.
  • Un aviso sobre los permisos, que son dos y son amplios. Según la referencia de GmailApp, buscar correos pide el permiso https://mail.google.com/, el acceso completo a tu Gmail. Y según la referencia de las carpetas de Drive, crear un archivo en una carpeta pide https://www.googleapis.com/auth/drive, el acceso completo a tu Drive (las dos, leídas dos veces el 15 de noviembre de 2026). El programa de esta guía solo lee correos y solo crea archivos, pero Google no sabe eso y te pedirá los dos permisos enteros. Por eso, pega solo un programa que hayas leído, como este, y no le des esos permisos a uno que te pase un desconocido.

Cómo funciona

  • La búsqueda de Gmail. GmailApp.search acepta la búsqueda “tal como la escribirías en Gmail”, según su referencia. El programa le añade dos cosas: has:attachment, para que solo traiga correos con adjuntos, y newer_than:7d, para que solo mire los últimos días. Según la ayuda de Gmail (consultada el 15 de noviembre de 2026), también sirven from: para el remitente, label: para una etiqueta y filename:pdf para un tipo de archivo.
  • La carpeta de Drive. Si no existe una carpeta con el nombre que eliges, el programa la crea en la raíz de tu Drive. Cada adjunto se guarda ahí como un archivo nuevo.
  • Los archivos. De cada correo toma los adjuntos sin las imágenes insertadas: según la referencia del correo (leída dos veces el 15 de noviembre de 2026), getAttachments() incluye por defecto las imágenes del texto, como el logo de una firma, y includeInlineImages: false las deja fuera. Si TIPOS tiene algo, se queda solo con esas extensiones, sin importar mayúsculas.
  • La memoria. Apunta cada correo revisado en el servicio de propiedades de Apps Script, que guarda pares de clave y valor para tu usuario y ese programa, y se salta los que ya tiene. Borra lo apuntado hace más de 31 días, porque la búsqueda nunca mira tan atrás: por eso DIAS no puede pasar de 30.
  • Un disparador de tiempo, que lo ejecuta cada hora aunque no tengas nada abierto.

Paso 1 · Prueba tu búsqueda en Gmail

Escribe la búsqueda en la caja de Gmail, con has:attachment, y mira qué sale: el programa encontrará los mismos correos.

Quieres guardar Búsqueda
Las facturas que guardas con una etiqueta label:facturas
Lo que te envía un proveedor o tu banco from:pagos@ejemplo.com
Solo los PDF de un remitente from:pagos@ejemplo.com filename:pdf
Todos los adjuntos que te llegan, no los que envías -from:me

Evita dejar la búsqueda vacía: guardarías todos los adjuntos, también los que envías tú y los de cualquier desconocido.

Paso 2 · Crea el programa y pégalo

  1. Entra en script.google.com con tu cuenta y pulsa New project (Nuevo proyecto). Arriba, pulsa “Untitled project” y ponle un nombre, por ejemplo “Adjuntos a Drive”. Los pasos salen de la guía de proyectos de Apps Script (leída el 15 de noviembre de 2026), que está en inglés: los botones pueden salirte en español.
  2. Se abre el editor con un archivo Código.gs. Borra lo que trae y pega esto:
// Guarda en una carpeta de Google Drive los adjuntos de los correos de Gmail
// que cumplen una búsqueda, sin repetir los que ya guardó.
const CARPETA = 'Adjuntos de Gmail';     // nombre de la carpeta en tu Drive
const BUSQUEDA = 'label:facturas';       // como la escribirías en Gmail
const DIAS = 7;                          // solo mira los correos de estos días
const TIPOS = [];                        // vacío: todos. Ejemplo: ['pdf', 'xml']
const MAXIMO = 50;                       // conversaciones por ejecución
const ENSAYO = true;                     // true: solo escribe en el registro

function guardarAdjuntos() {
  if (DIAS < 1 || DIAS > 30) throw new Error('DIAS tiene que ir de 1 a 30');
  const memoria = PropertiesService.getUserProperties();
  const vistos = memoria.getProperties();   // id del correo -> fecha en que se guardó
  const ahora = Date.now();
  const carpeta = ENSAYO ? null : buscarCarpeta();

  const consulta = BUSQUEDA + ' has:attachment newer_than:' + DIAS + 'd';
  let guardados = 0;
  GmailApp.search(consulta, 0, MAXIMO).forEach(conversacion => {
    conversacion.getMessages().forEach(correo => {
      const id = correo.getId();
      if (vistos[id]) return;
      const dia = Utilities.formatDate(correo.getDate(),
        Session.getScriptTimeZone(), 'yyyy-MM-dd');
      correo.getAttachments({ includeInlineImages: false }).forEach(adjunto => {
        const nombre = adjunto.getName();
        if (!tipoValido(nombre)) return;
        guardados++;
        if (ENSAYO) {
          console.log('  ' + dia + ' | ' + correo.getFrom() + ' | ' + nombre);
          return;
        }
        carpeta.createFile(adjunto.copyBlob().setName(dia + ' ' + nombre));
      });
      if (ENSAYO) return;
      vistos[id] = String(ahora);
      memoria.setProperty(id, vistos[id]); // se apunta en cuanto termina con este correo
    });
  });

  if (ENSAYO) {
    console.log('ENSAYO. Guardaría ' + guardados + ' adjuntos. Búsqueda: ' + consulta);
    return;
  }
  // La memoria olvida lo de hace más de 31 días: la búsqueda ya no llega tan atrás.
  const limite = ahora - 31 * 24 * 60 * 60 * 1000;
  Object.keys(vistos).forEach(id => {
    if (Number(vistos[id]) < limite) delete vistos[id];
  });
  memoria.setProperties(vistos, true);
  console.log('Guardados ' + guardados + ' adjuntos en "' + CARPETA + '".');
}

// Ejecuta esta una sola vez: deja el programa revisando el correo cada hora.
function instalarDisparador() {
  ScriptApp.newTrigger('guardarAdjuntos').timeBased().everyHours(1).create();
}

// Si borras la memoria, la siguiente ejecución vuelve a guardar todo lo de DIAS.
function borrarMemoria() {
  PropertiesService.getUserProperties().deleteAllProperties();
}

function buscarCarpeta() {
  const encontradas = DriveApp.getFoldersByName(CARPETA);
  return encontradas.hasNext() ? encontradas.next() : DriveApp.createFolder(CARPETA);
}

function tipoValido(nombre) {
  if (TIPOS.length === 0) return true;
  const punto = nombre.lastIndexOf('.');
  if (punto < 0) return false;
  return TIPOS.includes(nombre.slice(punto + 1).toLowerCase());
}
  1. Cambia la línea de BUSQUEDA por la tuya, entre comillas simples. Si tu búsqueda lleva comillas dobles, como subject:"Factura electrónica", déjalas: van dentro de las simples. No escribas has:attachment ni newer_than:: el programa los añade.
  2. Si quieres otro nombre de carpeta, cambia CARPETA.
  3. Guarda con el icono del disquete.

Paso 3 · Pruébalo en modo de ensayo

El programa empieza con ENSAYO = true: busca en Gmail y escribe en el registro qué archivos guardaría, con la fecha, el remitente y el nombre. No crea la carpeta, no guarda nada y no apunta nada en su memoria.

  1. En el menú de arriba del editor, elige la función guardarAdjuntos y pulsa Ejecutar.
  2. La primera vez, Google te pide autorizar el programa. Pedirá acceso a tu Gmail y a tu Drive: son los permisos amplios de “Qué necesitas”. Según la guía de permisos de Apps Script (leída el 15 de noviembre de 2026), la pantalla puede dejarte elegir qué permisos das; sin los dos, el programa fallará. Nadie ha visto todavía esa pantalla para esta guía (mira “Qué se comprobó”).
  3. Abajo, en el registro de ejecución, verás una línea por archivo y al final algo como ENSAYO. Guardaría 4 adjuntos. Búsqueda: label:facturas has:attachment newer_than:7d.

Paso 4 · Actívalo

  1. Cambia const ENSAYO = true; por const ENSAYO = false; y guarda.
  2. Ejecuta guardarAdjuntos una vez a mano. En tu Drive aparece la carpeta “Adjuntos de Gmail” con los archivos de los últimos 7 días, cada uno con la fecha del correo delante: 2026-11-13 Factura-118.pdf.
  3. Elige la función instalarDisparador y pulsa Ejecutar, una sola vez. Desde entonces, cada hora el programa guarda lo nuevo. Si lo ejecutas dos veces tendrás dos disparadores: gastas el doble de cuota y, si coinciden, pueden guardar algún archivo dos veces.
  4. Compruébalo: en el editor, a la izquierda, el icono del reloj (Triggers en la ayuda de Google, que está en inglés) lista los disparadores. Desde ahí también se borra.

Variaciones

Recuperar lo de antes. La primera vez, pon DIAS en 30 para guardar los adjuntos del último mes. Haz antes el ensayo: si son muchos, una ejecución puede pasar de los 6 minutos. Después vuelve a 7.

Cada menos tiempo. En instalarDisparador, cambia everyHours(1) por everyMinutes(30). Según la referencia del disparador (leída el 15 de noviembre de 2026), los minutos solo pueden ser 1, 5, 10, 15 o 30. Más a menudo gasta más de los 90 minutos diarios.

Volver a empezar. La función borrarMemoria vacía la memoria: la siguiente ejecución guardará otra vez todo lo de los últimos DIAS, incluido lo que ya estaba en la carpeta.

Qué se comprobó

  • El programa se ejecutó el 15 de noviembre de 2026 contra una simulación escrita en Node.js, no en Google. Se probaron estos casos: el modo de ensayo (no crea la carpeta ni apunta nada, cuenta bien y deja fuera la imagen de una firma), la búsqueda que arma, la primera ejecución real (crea la carpeta, guarda cuatro archivos con la fecha delante y apunta los tres correos), una segunda ejecución (no repite ni crea otra carpeta), el filtro TIPOS con pdf y xml (entra un .XML en mayúsculas y no un archivo sin extensión), el olvido de lo apuntado hace más de 31 días, un DIAS fuera de rango (da un error claro), una búsqueda sin resultados, una carpeta que ya existía, borrarMemoria, la creación del disparador y un corte en mitad de una ejecución (los correos terminados quedan apuntados y la siguiente ejecución completa el resto). Todos dieron lo esperado. La simulación no garantiza que Google se comporte igual en todo.
  • Nadie lo ha ejecutado todavía en una cuenta real, ni ha visto la pantalla de autorización. Los métodos que usa salen de la referencia oficial de Apps Script, enlazada en cada apartado y leída ese día.
  • Lo que la documentación no aclara: en qué orden devuelve Gmail las conversaciones; si tu búsqueda trae más de 50 en los últimos días, las que queden fuera puede que no se guarden nunca, así que acótala. Tampoco dice cuánto tarda en guardar archivos grandes: si una ejecución pasa de los 6 minutos se corta, y los adjuntos del correo que estaba a medias pueden quedar repetidos en la siguiente. La página de cuotas no da un límite de tamaño para los archivos que se crean así.

Errores comunes

  • El ensayo dice 0 adjuntos. Prueba en la caja de Gmail tu búsqueda con has:attachment newer_than:7d añadido: si ahí no sale nada, el programa tampoco lo encuentra.
  • Dejar el modo de ensayo puesto. Si la carpeta no aparece y en las ejecuciones ves ENSAYO. Guardaría…, no cambiaste ENSAYO a false.
  • Dos carpetas con el mismo nombre. En Drive puede haber varias carpetas con el mismo nombre (por eso getFoldersByName devuelve una lista), y el programa usa la primera que encuentra. Si los archivos no están donde esperas, busca en Drive el nombre de la carpeta.
  • Abrir un adjunto de un desconocido porque ya está en Drive. Guardarlo no lo hace más seguro. Acota la búsqueda a remitentes que conoces.
  • Si el programa falla, según la guía de disparadores Google te envía un correo con el resumen de los fallos, y en el editor, en Executions (Ejecuciones), ves cada ejecución con su error.

Para seguir

Para que la búsqueda sea fácil, empieza por que el correo llegue ya a su etiqueta con los filtros de Gmail: con label:facturas, el programa guarda justo lo que tu filtro clasifica. Y si quieres que una hoja de cálculo te escriba a ti o a otros, mira cómo enviar correos automáticos desde Google Sheets, con el mismo editor de Apps Script.

Recibe los prompts nuevos por correo

Al confirmar te llevas de regalo un PDF con los 62 prompts del sitio, listos para copiar. Sin spam, y te das de baja cuando quieras.

Te pediremos confirmar por correo. Al suscribirte aceptas la política de privacidad. Los envíos se gestionan con Kit.

Sigue con