Enviar e receber correio com a API Mail

Este guia descreve como usar a API Mail para enviar e receber correio.

Esta API é suportada para runtimes de primeira geração e pode ser usada quando atualizar para runtimes de segunda geração correspondentes. Se estiver a atualizar para o tempo de execução do App Engine Go 1.12 ou superior, consulte o guia de migração para saber mais sobre as suas opções de migração para serviços agrupados antigos.

Antes de começar

Tem de registar os seus emails de remetente como remetentes autorizados. Para mais informações, consulte quem pode enviar emails.

A enviar correio

Para enviar correio a partir da sua aplicação:

1. Use o tipo mail.Message para definir o remetente, o destinatário, o assunto e o corpo da mensagem.

2. Envie o email com a função mail.Send.

O exemplo seguinte envia uma mensagem de email ao utilizador como confirmação de que criou uma nova conta com a aplicação:

import (
	"bytes"
	"fmt"
	"net/http"

	"google.golang.org/appengine"
	"google.golang.org/appengine/log"
	"google.golang.org/appengine/mail"
)

func confirm(w http.ResponseWriter, r *http.Request) {
	ctx := appengine.NewContext(r)
	addr := r.FormValue("email")
	url := createConfirmationURL(r)
	msg := &mail.Message{
		Sender:  "Example.com Support <[e-mail]>",
		To:      []string{addr},
		Subject: "Confirm your registration",
		Body:    fmt.Sprintf(confirmMessage, url),
	}
	if err := mail.Send(ctx, msg); err != nil {
		log.Errorf(ctx, "Couldn't send email: %v", err)
	}
}

const confirmMessage = `
Thank you for creating an account!
Please confirm your email address by clicking on the link below:

%s
`

Receber correio

Pode configurar a sua app para receber emails recebidos em endereços no seguinte formato:

[e-mail]

Nota: mesmo que a sua app esteja implementada num domínio personalizado, não pode receber emails enviados para endereços nesse domínio.

Para receber emails:

1. Ative o correio recebido no ficheiro app.yaml da sua app:

   inbound_services:
   - mail

2. Configure um controlador para processar emails recebidos, que são fornecidos à sua app como dados MIME num pedido HTTP POST.

   1. Na sua app, registe um controlador no caminho /_ah/mail/:

      func init() {
      	http.HandleFunc("/_ah/mail/", incomingMail)
      }
      

   2. No controlador, leia os dados do email a partir de *http.Request:

      func incomingMail(w http.ResponseWriter, r *http.Request) {
      	ctx := appengine.NewContext(r)
      	defer r.Body.Close()
      	var b bytes.Buffer
      	if _, err := b.ReadFrom(r.Body); err != nil {
      		log.Errorf(ctx, "Error reading body: %v", err)
      		return
      	}
      	log.Infof(ctx, "Received mail: %v", b)
      }
      

   Pode usar o pacote net/mail na biblioteca padrão para analisar mensagens de correio.