Descripción general de la API de correo

Las aplicaciones de App Engine pueden enviar mensajes de correo electrónico de parte de las direcciones receptoras de correo y de parte 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.

Cómo enviar 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 G Suite del usuario que ha accedido actualmente
  • Cualquier dirección de correo electrónico del formulario anything@[MY_PROJECT_ID].appspotmail.com o anything@[MY_PROJECT_NUMBER].appspotmail.com
  • Cualquier dirección de correo electrónico que aparezca en GCP Console entre los remitentes autorizados de la API de correo electrónico

Todas las direcciones de correo electrónico de los remitentes autorizados de la API de correo electrónico 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 para el cual sea propietario o administrador.
  • Aplicaciones alojadas en un dominio de G Suite: noreply@[DOMAIN].com, siempre que noreply@[DOMAIN].com sea una cuenta válida (usuario o grupo).

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

Está limitado a un máximo de 50 remitentes autorizados.

Correo de G Suite

Si vas a enviar un correo electrónico desde un dominio administrado por G Suite, debes configurar los registros SPF de DNS de tu dominio a fin de indicar que Google es una fuente confiable para el correo electrónico. Para obtener instrucciones sobre cómo hacerlo, consulta la información sobre los registros SPF en los artículos de ayuda de G Suite.

Ten en cuenta que si utilizas alias configurados para tu dominio de G Suite, no podrás enviar correos electrónicos desde direcciones que usen el alias de 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.

Correo electrónico y el servidor de desarrollo

Cuando una aplicación en ejecución en el servidor de desarrollo llama al servicio de correo electrónico para enviar un mensaje, el mensaje se imprime en los registros de la aplicación. El servidor de desarrollo no envía el mensaje del correo electrónico.

Autenticación con DomainKeys Identified Mail (DKIM)

Cuando envías un correo, App Engine utiliza el estándar de correo identificado de DomainKeys (DKIM) para autenticar el dominio. Si tu aplicación envía mensajes desde una dirección de correo electrónico que forma parte de un dominio de G Suite, 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 realmente vino 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 G Suite, sigue estas instrucciones en el Centro de ayuda de G Suite. Ten en cuenta que pueden pasar hasta 48 horas antes de que la autenticación DKIM esté activa para tu dominio de G Suite.

También debes asegurarte de que tu aplicación esté usando un dominio personalizado y sea igual que el dominio de G Suite. También ten en cuenta que no se permiten dominios de G Suite con subdominios, como subdomain.example.com.

App Engine firmará los correos salientes de la aplicación si la dirección del remitente es parte de un dominio de G Suite con DKIM habilitado. Además, la dirección del remitente debe tener un formato tal 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 tu aplicación, ve a la página Detalles de la cuota en Google Cloud Platform 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 diariamente. Si excedes la cuota diaria, recibirás una excepción por superar la cuota. Si necesitas enviar más correos electrónicos que lo permitido por la cuota, puedes usar un proveedor de correo electrónico de terceros, como SendGrip 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