Descripción general de la API de correo electrónico

Las aplicaciones de App Engine pueden enviar mensajes por correo electrónico en representación de las direcciones receptoras de correo y en nombre de algunos usuarios con Cuentas de Google. Las apps pueden recibir correos electrónicos en varias direcciones. Las apps envían mensajes con este servicio y reciben mensajes en forma de solicitudes HTTP que App Engine inició y envió a la app.

Envía correos electrónicos

El servicio de correo puede enviar mensajes de correo electrónico a uno o más destinatarios. Un mensaje contiene un asunto, un cuerpo de texto sin formato y un cuerpo HTML opcional. También puede contener archivos adjuntos y un conjunto limitado de encabezados.

Puedes utilizar cualquier dirección de correo electrónico para un destinatario. Un destinatario puede estar en el campo "a" del mensaje, en el campo "cc", o escondido de los destinatarios del mensaje (en "copia oculta" o "bcc").

Cuando una aplicación llama al servicio de correo para enviar un mensaje, este se pone en fila y la llamada se muestra de inmediato. El servicio de correo utiliza procedimientos estándar para comunicarse con el servidor de correo de cada destinatario, entregar el mensaje y volver a intentarlo si no se puede establecer contacto con el servidor de correo.

Quiénes pueden enviar correos

Por motivos de seguridad, la dirección del remitente de un mensaje debe ser una de las siguientes:

  • La cuenta de Gmail o Google Workspace del usuario cuya sesión se encuentra activa
  • Cualquier dirección de correo electrónico con el formato anything@[MY_PROJECT_ID].appspotmail.com o anything@[MY_PROJECT_NUMBER].appspotmail.com
  • Cualquier dirección de correo electrónico que aparezca en la lista de Cloud Console en Remitentes autorizados de API de correo

Todas las direcciones de correo electrónico de los Remitentes autorizados de API de correo deben ser cuentas de dominio válidas alojadas en Google o Gmail. Los administradores de apps pueden agregar las siguientes cuentas a la lista de remitentes autorizados:

  • Su propia dirección de correo electrónico.
  • Cualquier grupo en el que sea propietario o administrador
  • Aplicaciones alojadas en un dominio de Google Workspace: noreply@[DOMAIN].com, siempre que noreply@[DOMAIN].com sea una cuenta válida (usuario o grupo)

Además, los administradores de dominios administrados por Google Workspace pueden agregar cualquier usuario de su dominio a la lista de remitentes autorizados.

Puedes agregar un máximo de 50 remitentes autorizados.

Correo electrónico de Google Workspace

Si deseas enviar un correo electrónico desde un dominio administrado por Google Workspace, debes configurar los registros de DNS SPF a fin de que el dominio indique que Google es una fuente confiable para el correo electrónico. Para obtener instrucciones sobre cómo hacerlo, consulta los registros SPF en el Centro de ayuda de Google Workspace.

Ten en cuenta que si usas alias configurados para tu dominio de Google Workspace, no podrás enviar correos electrónicos desde direcciones que usen el alias del dominio.

Notificaciones de rebote cuando no se entrega el correo

Es posible que el correo que coincida con una firma conocida de correo no deseado, virus o contenido malicioso no se acepte para la entrega.

Si el servicio de correo no puede entregar un mensaje, o si el servidor de correo de un destinatario muestra un mensaje de rebote (por ejemplo, porque no hay una cuenta con esa dirección en el sistema), se puede enviar un mensaje de error por correo electrónico a la dirección del remitente del mensaje La aplicación en sí no recibe ninguna notificación sobre si la entrega se realizó correctamente o no.

De forma predeterminada, las notificaciones de rebote de correo electrónico no están habilitadas. Si deseas recibir notificaciones de rebote de correo electrónico, tendrás que configurar tu aplicación. Para obtener más información, consulta Cómo recibir notificaciones de rebote.

El correo y el servidor de desarrollo

El servidor de desarrollo puede configurarse para enviar mensajes de correo electrónico directamente desde tu computadora cuando pruebas una función de la app que envía mensajes. Puedes configurar el servidor de desarrollo para usar un servidor SMTP de tu elección. También puedes indicarle al servidor de desarrollo que use Sendmail, si está instalado en tu computadora y configurado para enviar correos electrónicos.

Si no configuras un servidor SMTP ni habilitas Sendmail, el servidor de desarrollo registrará el contenido de los mensajes cuando tu app envía una llamada al servicio de Correo. Los mensajes no se enviarán.

Autenticación con DomainKeys Identified Mail (DKIM)

Cuando envías un correo electrónico, App Engine usa el mecanismo DomainKeys Identified Mail (DKIM) estándar para autenticar el dominio. Si la aplicación envía mensajes desde una dirección de correo electrónico que forma parte de un dominio de Google Workspace, App Engine puede firmar de forma criptográfica los correos electrónicos que envía. Esta firma dice que un correo electrónico que pretende ser de emma@example.com en realidad provino de example.com. El destinatario puede comprobar esta firma; si la firma es correcta, el destinatario sabe que el dominio del remitente no fue falsificado.

Si quieres habilitar la autenticación DKIM para mensajes enviados desde direcciones de correo electrónico de Google Workspace, sigue estas instrucciones en el Centro de ayuda de Google Workspace. Ten en cuenta que pueden pasar hasta 48 horas antes de que la autenticación DKIM esté activa para el dominio de Google Workspace.

También debes asegurarte de que la aplicación use un dominio personalizado y sea igual que el dominio de Google Workspace. Además, debes tener en cuenta que no se permiten dominios de Google Workspace con subdominios como subdomain.example.com.

App Engine firmará los correos electrónicos salientes de la aplicación si la dirección del remitente es parte de un dominio de Google Workspace con DKIM habilitado. Además, la dirección del remitente debe tener un formato en el que la parte del dominio de la dirección de correo electrónico solo esté formada por letras minúsculas.

Cuotas y límites

Para ver el uso de la cuota actual de la aplicación, ve a la página Detalles de la cuota en Google Cloud Console.

Ir a la página Detalles de la cuota

Cada solicitud de servicio de correo se cuenta dentro de la cuota de llamadas a la API de correo. También hay cuotas para la cantidad de mensajes que puedes enviar, la cantidad de mensajes de administrador y la cantidad de datos y archivos adjuntos que puedes enviar. Para obtener más información, consulta Cuotas de correo.

La cuota se restablece a diario. Si excedes la cuota diaria, recibirás una excepción por superar la cuota. Si necesitas enviar más correos que los que permite la cuota, puedes usar un proveedor de correo de terceros, como SendGrid o Mailgun.

Además de las cuotas, se aplican los siguientes límites al servicio de correo:

Límite Cantidad
Tamaño máximo de los mensajes de correo salientes, incluidos los archivos adjuntos 31.5 MB
Tamaño máximo de los mensajes de correo entrantes, incluidos los archivos adjuntos 31.5 MB
Tamaño máximo del mensaje cuando uno de los destinatarios es un administrador 16 KB
Cantidad máxima de remitentes autorizados 50

Pasos siguientes