Nivel de codificación: Principiante
Duración: 10 minutos
Tipo de proyecto: Automatización con un menú personalizado
¿Prefiere aprender mediante videos?
El canal para desarrolladores de Google Workspace ofrece videos sobre sugerencias, trucos y las funciones más recientes.
|
Objetivos
- Comprenda lo que hace la solución.
- Comprende lo que hacen los servicios de Apps Script en la solución.
- Configura la secuencia de comandos.
- Ejecuta la secuencia de comandos.
Acerca de esta solución
Propaga automáticamente una plantilla de correo electrónico con datos de Hojas de cálculo de Google. Los correos electrónicos se envían desde tu cuenta de Gmail para que puedas responder a las respuestas de los destinatarios.
Importante: Esta muestra de combinación de correos electrónicos está sujeta a los límites que se describen en Cuotas para servicios de Google.
Cómo funciona
Creas una plantilla de borrador de Gmail con marcadores de posición que corresponden a los datos en un archivo de Hojas de cálculo. Cada encabezado de columna en una hoja representa una etiqueta de marcador de posición. La secuencia de comandos envía la información de cada marcador de posición de la hoja de cálculo a la ubicación de la etiqueta del marcador de posición correspondiente en el borrador de tu correo electrónico.
Servicios de Apps Script
En esta solución, se usan los siguientes servicios:
- Servicio de Gmail: Obtiene, lee y envía el borrador de correo electrónico que deseas enviar a tus destinatarios.
- Si tu correo electrónico incluye caracteres Unicode, como los emojis, usa el Servicio de correo electrónico en su lugar. Obtén información sobre cómo actualizar el código para que incluya caracteres Unicode en tu correo electrónico.
- Servicio de hoja de cálculo: completa los marcadores de posición de correo electrónico con la información personalizada para cada uno de los destinatarios.
Requisitos previos
Para usar esta muestra, necesitas los siguientes requisitos previos:
- Una Cuenta de Google (las cuentas de Google Workspace pueden requerir la aprobación del administrador).
- Un navegador web con acceso a Internet.
Configure la secuencia de comandos
Cree el proyecto de Apps Script
- Haz clic en el siguiente botón para hacer una copia de la hoja de cálculo de muestra de Combinación de correos electrónicos de Gmail y Hojas de cálculo.
El proyecto de Apps Script para esta solución se adjunta a la hoja de cálculo.
Crear una copia - En la hoja de cálculo que copiaste, actualiza la columna Destinatarios con las direcciones de correo electrónico que deseas usar en la combinación de correos electrónicos.
- Agrega, edita o quita columnas para personalizar los datos que deseas incluir en tu plantilla de correo electrónico (opcional).
Si cambias el nombre de las columnas Destinatario o Correo electrónico enviado, debes actualizar el código correspondiente en el proyecto de Apps Script. Para abrir el proyecto de Apps Script desde la hoja de cálculo, haz clic en Extensiones > Apps Script.
Crear una plantilla de correo electrónico
- En tu cuenta de Gmail, crea un borrador de correo electrónico. Para incluir datos de la hoja de cálculo en tu correo electrónico, usa marcadores de posición que correspondan a nombres de columna entre llaves, como
{{First name}}
.- Si le das formato al texto del correo electrónico, también debes dar formato a los corchetes del marcador de posición.
- Los marcadores de posición distinguen mayúsculas de minúsculas y deben coincidir exactamente con los encabezados de columna.
- Copia el asunto del borrador de tu correo electrónico.
Ejecuta la secuencia de comandos:
- En la hoja de cálculo, haz clic en Combinar el correo > Enviar correos electrónicos. Es posible que debas actualizar la página para que aparezca este menú personalizado.
Cuando se te solicite, autoriza la secuencia de comandos. Si la pantalla de consentimiento de OAuth muestra la advertencia This app is not verified, continúa seleccionando Advanced > Go to {Project Name} (no seguro).
Haz clic en Combinar el correo > Enviar correos electrónicos de nuevo.
Pega la línea de asunto de la plantilla de correo electrónico y haz clic en Aceptar.
Si aplicaste un filtro a la hoja, la secuencia de comandos seguirá enviando correos electrónicos a los participantes filtrados, pero no agregará la marca de tiempo.
Revisa el código
Para revisar el código de Apps Script de esta solución, haz clic en Ver código fuente a continuación:
Ver el código fuente
Code.gs
Modificaciones
Puede editar la automatización de la fusión de correspondencia tanto como desee. A continuación, se muestran algunos cambios opcionales que puedes realizar en el código fuente.
Agrega parámetros de Cco, Cc, Responder a o De correo electrónico
El código de muestra incluye una serie de parámetros adicionales, actualmente comentados, que te permiten controlar el nombre de la cuenta desde la que se envía el correo electrónico, responder a direcciones de correo electrónico, así como direcciones de correo electrónico en Cco y Cc.
Para activar los parámetros que deseas agregar, quita las barras diagonales //
delante de cada uno.
En el siguiente ejemplo, se muestra un extracto de la función sendEmails
que activa la mayoría de los parámetros de correo electrónico:
GmailApp.sendEmail(row[RECIPIENT_COL], msgObj.subject, msgObj.text, { htmlBody: msgObj.html, bcc: 'bcc@example.com', cc: 'cc@example.com', from: 'from.alias@example.com', name: 'name of the sender', replyTo: 'reply@example.com', // noReply: true, // if the email should be sent from a generic no-reply email address (not available to gmail.com users)
En el ejemplo anterior, el parámetro noReply
aún tiene un comentario porque el parámetro replyTo
está configurado.
Incluya caracteres Unicode en sus correos electrónicos
Si deseas incluir caracteres Unicode, como emojis, en tus correos electrónicos, debes actualizar el código para usar el servicio de correo en lugar del servicio de Gmail.
En el código de muestra, actualiza la siguiente línea:
GmailApp.sendEmail(row[RECIPIENT_COL], msgObj.subject, msgObj.text, {
Reemplaza la línea por el siguiente código:
MailApp.sendEmail(row[RECIPIENT_COL], msgObj.subject, msgObj.text, {
Colaboradores
La muestra la creó Martin Hawksey, líder de Diseño y Tecnología de Aprendizaje del Edinburgh Futures Institute, blogger y experto en desarrolladores de Google.
- Encuentra a Martín en Twitter @mhawksey.
- Lee las entradas de blog relacionadas con Martín de Google Apps Script.
- Mira el programa de YouTube de Totally Unscripted.
Google mantiene esta muestra con la ayuda de los expertos de Google Developers.