使用 Mail API 发送和接收邮件

本指南介绍如何使用 Mail API 发送和接收邮件。

准备工作

您必须将您的发件人电子邮件注册为已获授权的发件人。如需了解详情,请参阅谁可以发送电子邮件

发送邮件

如需从您的应用发送邮件,请执行以下操作:

  1. 使用 mail.Message 类型设置邮件的发件人、收件人、主题和正文。

  2. 使用 mail.Send 函数发送电子邮件。

以下示例会向用户发送电子邮件,确认他们是否已在应用中创建新帐号:

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 <support@example.com>",
		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
`

接收邮件

您可以对应用进行设置,通过如下格式的地址接收传入电子邮件:

anything@appid.appspotmail.com

如需接收电子邮件,请执行以下操作:

  1. 在应用的 app.yaml 文件中启用接收邮件。

    inbound_services:
    - mail
  2. 设置处理程序以处理传入的电子邮件,这些电子邮件作为 HTTP POST 请求中的 MIME 数据提供给您的应用。

    1. 在您的应用中,将处理程序注册到 /_ah/mail/ 路径:

      func init() {
      	http.HandleFunc("/_ah/mail/", incomingMail)
      }
      
    2. 在处理程序中,从 *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)
      }
      

    您可以使用标准库中的 net/mail 软件包来解析邮件。