API Mail para serviços agrupados antigos

As aplicações do App Engine podem enviar mensagens de email em nome dos endereços de receção de email da app e em nome de alguns utilizadores com Contas Google. As apps podem receber email em vários endereços. As apps enviam mensagens através do serviço Mail e recebem mensagens sob a forma de pedidos HTTP iniciados pelo App Engine e publicados na app.

A enviar correio

O serviço de correio pode enviar mensagens de email para um ou mais destinatários. Uma mensagem contém um assunto, um corpo de texto simples e um corpo HTML opcional. Também pode conter anexos de ficheiros e um conjunto limitado de cabeçalhos.

Pode usar qualquer endereço de email para um destinatário. Um destinatário pode estar no campo "para" da mensagem, no campo "cc" ou oculto dos destinatários da mensagem (uma "cópia oculta" ou "cco").

Quando uma aplicação chama o serviço de correio para enviar uma mensagem, a mensagem é colocada em fila, e a chamada é devolvida imediatamente. O serviço de correio usa procedimentos padrão para contactar o servidor de correio de cada destinatário, entregar a mensagem e tentar novamente se não for possível contactar o servidor de correio.

Quem pode enviar correio

Por motivos de segurança, o endereço do remetente de uma mensagem tem de ser um dos seguintes:

  • A Conta do Gmail ou do Google Workspace do utilizador que tem sessão iniciada
  • Qualquer endereço de email no formato anything@[MY_PROJECT_ID].appspotmail.com ou anything@[MY_PROJECT_NUMBER].appspotmail.com
  • Qualquer endereço de email listado na Google Cloud consola em Remetentes autorizados da API Email

Todos os endereços de email na lista de remetentes autorizados da API Email têm de ser contas válidas do Gmail ou de domínio alojadas pela Google. Os administradores da app podem adicionar as seguintes contas à lista de remetentes autorizados:

  • O seu próprio endereço de email
  • Qualquer grupo do qual seja proprietário ou gestor
  • Aplicações alojadas num domínio do Google Workspace: noreply@[DOMAIN].com, desde que noreply@[DOMAIN].com seja uma conta válida (utilizador ou grupo).

Além disso, os administradores de domínio dos domínios geridos pelo Google Workspace podem adicionar qualquer utilizador no respetivo domínio à lista de remetentes autorizados.

Está limitado a um máximo de 50 remetentes autorizados.

Correio do Google Workspace

Se enviar emails a partir de um domínio gerido pelo Google Workspace, deve definir os registos SPF de DNS para o seu domínio de modo a indicar que a Google é uma fonte fidedigna para o seu email. Para obter instruções sobre como fazê-lo, consulte os registos SPF no Centro de Ajuda do Google Workspace.

Tenha em atenção que, se usar aliases configurados para o seu domínio do Google Workspace, não pode enviar emails a partir de endereços de email que usam o alias do domínio.

Receba notificações de rejeição quando o email não for entregue

O email que corresponda a uma assinatura conhecida de spam, vírus ou outro conteúdo malicioso pode não ser aceite para entrega.

Se o serviço de correio não conseguir entregar uma mensagem ou se o servidor de correio de um destinatário devolver uma mensagem de rejeição (por exemplo, porque não existe uma conta para esse endereço nesse sistema), pode ser enviada uma mensagem de erro por email para o endereço do remetente da mensagem. A própria aplicação não recebe nenhuma notificação sobre se a entrega foi bem-sucedida ou falhou.

Por predefinição, as notificações de rejeição de email não estão ativadas. Para receber notificações de rejeição de email, tem de configurar a sua aplicação. Para mais detalhes, consulte o artigo Receber uma notificação de rejeição.

Correio e servidor de programação

O servidor de desenvolvimento pode ser configurado para enviar mensagens de email diretamente a partir do seu computador quando testa uma funcionalidade da sua app que envia mensagens. Pode configurar o servidor de desenvolvimento para usar um servidor SMTP à sua escolha. Em alternativa, pode indicar ao servidor de desenvolvimento para usar o Sendmail, se o Sendmail estiver instalado no seu computador e configurado para enviar emails.

Se não configurar um servidor SMTP nem ativar o Sendmail, quando a sua app chamar o serviço de correio, o servidor de desenvolvimento regista o conteúdo da mensagem. A mensagem não é enviada.

Autenticação com DomainKeys Identified Mail (DKIM)

Quando envia correio, o App Engine usa a norma DomainKeys Identified Mail (DKIM) para autenticar o domínio. Se a sua aplicação enviar mensagens a partir de um endereço de email que faça parte de um domínio do Google Workspace, o App Engine pode assinar criptograficamente os emails que envia. Esta assinatura indica que um email que alega ser da emma@example.com foi realmente enviado por example.com. O destinatário pode verificar esta assinatura. Se a assinatura estiver correta, o destinatário sabe que o domínio do remetente não foi roubado.

Para ativar a autenticação DKIM para mensagens enviadas a partir de endereços de email do Google Workspace, siga estas instruções no Centro de Ajuda do Google Workspace. Tenha em atenção que a autenticação DKIM pode demorar até 48 horas a ficar ativa para o seu domínio do Google Workspace.

Também tem de garantir que a sua aplicação usa um domínio personalizado e que é o mesmo que o seu domínio do Google Workspace. Tenha também em atenção que não são permitidos domínios do Google Workspace com subdomínios, como subdomain.example.com.

O App Engine assina os emails enviados pela aplicação se o endereço do remetente fizer parte de um domínio do Google Workspace com o DKIM ativado. Além disso, o endereço do remetente tem de estar formatado de modo que a parte do domínio do endereço de email consista apenas em letras minúsculas.

Quotas e limites

Para ver a utilização atual da quota da sua aplicação, aceda à página Detalhes da quota na Google Cloud consola.

Aceda à página Detalhes da quota

Cada pedido do serviço de correio conta para a quota de Chamadas da API Mail. Também existem quotas para o número de mensagens que pode enviar, o número de mensagens de administrador que pode enviar e a quantidade de dados e anexos que pode enviar. Para mais detalhes, consulte o artigo Quotas de correio.

A quota é reposta diariamente. Se exceder a quota diária, recebe uma exceção de quota excedida. Se precisar de enviar mais correio do que a quota permite, pode usar um fornecedor de correio de terceiros, como o SendGrid ou o Mailgun.

Além das quotas, os seguintes limites aplicam-se ao serviço de correio:

Limite Montante
Tamanho máximo das mensagens de correio enviadas, incluindo anexos 31,5 MB
Tamanho máximo das mensagens de correio recebidas, incluindo anexos 31,5 MB
Tamanho máximo da mensagem quando um administrador é um destinatário 16 KB
Número máximo de remetentes autorizados 50

O que se segue?