Visão geral da Mail API

Os aplicativos do App Engine podem enviar mensagens de e-mail em nome dos endereços de recebimento de e-mail do app e em nome de alguns usuários com Contas do Google. Os apps podem receber e-mails em vários endereços. Os apps 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 app.

Como 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. Ele 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 "bcc").

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-mail

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

  • a conta do Gmail ou do G Suite do usuário conectado no momento;
  • qualquer endereço de e-mail do formulário, anything@[APP_NAME].appspotmail.com ou anything@[APP_ALIAS].appspotmail.com;
  • qualquer endereço de e-mail listado no console do GCP em Remetentes autorizados da Email API.

Todos os endereços de e-mail na lista de remetentes autorizados da Email API precisam ser contas de domínio do Gmail válidas ou hospedadas pelo Google. Os administradores de apps 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 G Suite: noreply@[DOMAIN].com, desde que noreply@[DOMAIN].com seja uma conta válida (usuário ou grupo).

Além disso, administradores de domínios gerenciados pelo G Suite 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 G Suite

Se enviar e-mails por um domínio gerenciado pelo G Suite, você precisará 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 nos artigos de ajuda do G Suite.

Se usar aliases configurados para o domínio do G Suite, você não poderá enviar e-mails 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 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, na sigla em inglês)

Quando você envia e-mail, o App Engine usa o padrão DKIM para autenticar o domínio. Se o aplicativo enviar mensagens por um endereço de e-mail que faça parte de um domínio do G Suite, 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 a assinatura estiver correta, o destinatário saberá que o domínio do remetente não sofreu spoofing.

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

Também verifique se o aplicativo está usando um domínio personalizado e igual ao domínio do G Suite. Os domínios do G Suite com subdomínios, como subdomain.example.com, não são permitidos.

O App Engine assinará os e-mails de envio do aplicativo se o endereço do remetente fizer parte de um domínio do G Suite 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 seja composta apenas por 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 Platform.

Acessar a página "Detalhes da cota"

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

A cota é redefinida diariamente. Se exceder a cota diária, você receberá uma exceção de cota excessiva. Se precisar enviar mais e-mails do que o permitido pela cota, você poderá usar um provedor de e-mail terceirizado, como SendGrid ou Mailgun.

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

Limite Valor
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

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente padrão do App Engine para Java