Envoyer et recevoir des e-mails avec l'API Mail

Ce guide explique comment utiliser l'API Mail pour envoyer et recevoir des e-mails.

Cette API est compatible avec les environnements d'exécution de première génération et peut être utilisée lors de la mise à niveau vers des environnements d'exécution de deuxième génération correspondants. Si vous effectuez une mise à jour vers l'environnement d'exécution Go 1.12+ d'App Engine, consultez le guide de migration pour en savoir plus sur les options de migration des anciens services groupés.

Avant de commencer

Vous devez enregistrer vos adresses e-mail d'expédition en tant qu'expéditeurs autorisés. Pour en savoir plus, consultez la section Utilisateurs autorisés à envoyer des e-mails.

Envoyer des e-mails

Pour envoyer un message depuis l'application, procédez comme suit :

1. Utilisez le type mail.Message pour définir l'expéditeur, le destinataire, l'objet et le corps du message.

2. Envoyez le message à l'aide de la fonction mail.Send.

L'exemple suivant envoie un e-mail à l'utilisateur pour confirmer la création de son compte via l'application :

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
`

Recevoir des messages

Vous pouvez configurer votre application afin que les messages entrants soient reçus par certaines adresses au format suivant :

[e-mail]

Remarque : Même si votre application est déployée sur un domaine personnalisé, vous ne pouvez pas recevoir d'e-mails envoyés aux adresses de ce domaine.

Pour recevoir des e-mails, procédez comme suit :

1. Activez les messages entrants dans le fichier app.yaml de votre application :

   inbound_services:
   - mail

2. Configurez un gestionnaire pour traiter les messages entrants, qui sont fournis à votre application sous forme de données MIME dans une requête HTTP POST.

   1. Dans votre application, enregistrez un gestionnaire au chemin d'accès /_ah/mail/ :

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

   2. Dans le gestionnaire, lisez les données des e-mails à partir de la requête *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)
      }
      

   Vous pouvez utiliser le package net/mail de la bibliothèque standard pour analyser les messages.