Visão geral da API Mail

Os aplicativos do App Engine podem enviar mensagens de e-mail em nome dos endereços de recebimento de e-mail do aplicativo e em nome de alguns usuários com Contas do Google. Esses aplicativos podem receber e-mails em vários endereços. Eles enviam mensagens usando o serviço de E-mail e recebem mensagens na forma de solicitações HTTP iniciadas pelo App Engine e postadas no aplicativo.

Enviar e-mails

O serviço de E-mail pode enviar mensagens de e-mail para um ou mais destinatários. Uma mensagem contém um assunto, um corpo de texto sem formatação e um corpo HTML opcional. Ela também pode conter anexos de arquivo e um conjunto limitado de cabeçalhos.

Use qualquer endereço de e-mail para um destinatário. Um destinatário pode estar no campo "para" da mensagem, no campo "cc" ou oculto para os destinatários da mensagem (uma "cópia oculta" ou "cco").

Quando um aplicativo chama o serviço de E-mail para enviar uma mensagem, essa mensagem é enfileirada e a chamada é retornada imediatamente. O serviço de E-mail usa procedimentos padrão para entrar em contato com o servidor de e-mail de cada destinatário, entregando a mensagem e repetindo caso não seja possível entrar em contato com o servidor de e-mail.

Quem pode enviar e-mails

Por motivos de segurança, o endereço do remetente de uma mensagem precisa ser um destes:

  • A conta do Gmail ou do Google Workspace do usuário que está conectado no momento
  • Qualquer endereço de e-mail no formato anything@[MY_PROJECT_ID].appspotmail.com ou anything@[MY_PROJECT_NUMBER].appspotmail.com
  • Qualquer endereço de e-mail listado no Console do Cloud em Remetentes autorizados da API Email

Todos os endereços de e-mail na lista de remetentes autorizados da API Mail precisam ser contas de domínio do Gmail válidas ou hospedadas pelo Google. Os administradores de aplicativos podem adicionar as seguintes contas à lista de remetentes autorizados:

  • O próprio endereço de e-mail
  • Qualquer grupo de que sejam proprietários ou gerentes
  • Aplicativos hospedados em um domínio do Google Workspace: noreply@[DOMAIN].com, desde que noreply@[DOMAIN].com seja uma conta válida (de usuário ou grupo).

Além disso, administradores de domínios gerenciados pelo Google Workspace podem adicionar qualquer usuário no domínio deles à lista de remetentes autorizados.

Você está limitado a um máximo de 50 remetentes autorizados.

E-mail do Google Workspace

Se você enviar e-mails por um domínio gerenciado pelo Google Workspace, será necessário definir os registros SPF DNS do domínio para indicar que o Google é uma fonte confiável para o e-mail. Para instruções sobre como fazer isso, consulte registros SPF na Central de Ajuda do Google Workspace.

Se você usar aliases configurados para o domínio do Google Workspace, não será possível enviar e-mails a partir de endereços que usem o alias de domínio.

Notificações de rejeições quando o e-mail não é entregue

Os e-mails correspondentes a uma assinatura conhecida de spam, vírus ou outro conteúdo mal-intencionado podem não ser aceitos para entrega.

Se o serviço de E-mail não conseguir entregar uma mensagem ou se o servidor de e-mail do destinatário retornar uma mensagem de rejeição (por exemplo, porque não há conta para esse endereço nesse sistema), uma mensagem de erro poderá ser enviada por e-mail para o endereço do remetente da mensagem. O próprio aplicativo não recebe nenhuma notificação sobre o êxito ou a falha na entrega.

Por padrão, as notificações de rejeições de e-mail não estão ativadas. Para receber notificações de rejeições por e-mail, você precisa configurar o aplicativo. Para mais detalhes, consulte Como receber notificação de rejeições.

E-mail e o servidor de desenvolvimento

Quando um aplicativo em execução no servidor de desenvolvimento chama o serviço de E-mail para enviar uma mensagem de e-mail, a mensagem é impressa nos registros de aplicativo. O servidor de desenvolvimento não envia a mensagem de e-mail.

Autenticação com e-mail identificado por DomainKeys (DKIM)

Quando você envia e-mail, o App Engine usa o padrão de e-mail identificado por DomainKeys (DKIM na sigla em inglês) para autenticar o domínio. Se o aplicativo enviar mensagens por um endereço que faça parte de um domínio do Google Workspace, o App Engine poderá assinar de maneira criptográfica os e-mails enviados. Essa assinatura diz que um e-mail que parece ser de emma@example.com realmente veio de example.com. O destinatário pode verificar essa assinatura. Se ela estiver correta, o destinatário saberá que o domínio do remetente não sofreu spoofing.

Para ativar a autenticação DKIM para mensagens enviadas de endereços de e-mail do Google Workspace, siga estas instruções na Central de Ajuda do Google Workspace. Pode demorar até 48 horas para que a autenticação DKIM esteja ativa no seu domínio do Google Workspace.

Verifique também se o aplicativo está usando um domínio personalizado e é igual ao domínio do Google Workspace. Observe também que os domínios do Google Workspace com subdomínios como subdomain.example.com não são permitidos.

O App Engine assinará os e-mails enviados do aplicativo se o endereço do remetente fizer parte de um domínio do Google Workspace com DKIM ativado. Além disso, o endereço do remetente precisa ser formatado de maneira que a parte de domínio do endereço de e-mail tenha apenas letras minúsculas.

Cotas e limites

Para ver o uso atual da cota do aplicativo, acesse a página "Detalhes da cota" no Console do Google Cloud.

Acessar a página "Detalhes da cota"

Cada solicitação de serviço de E-mail é contabilizada em relação à cota de Chamadas da API Mail. Também há cotas para o número de mensagens, a quantidade de mensagens administrativas e o volume de dados e anexos que você pode enviar. Para mais detalhes, consulte Cotas de e-mail.

A cota é redefinida diariamente. Se você exceder a cota diária, receberá uma exceção de limite de cota. Caso seja necessário enviar mais e-mails do que o permitido pela cota, use um provedor de e-mail terceirizado, como o SendGrid ou o Mailgun.

Além das cotas, os seguintes limites se aplicam ao serviço E-mail:

Limite Quantidade
Tamanho máximo de mensagens de e-mail enviadas, inclusive anexos 31,5 MB
Tamanho máximo de mensagens de e-mail recebidas, inclusive 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

Próximas etapas