使用 Mail API 发送和接收邮件

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

此 API 支持第一代运行时，并可在升级到相应的第二代运行时后使用。如果要更新到 App Engine Go 1.12+ 运行时，请参阅迁移指南以了解旧版捆绑服务的迁移选项。

准备工作

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

发送邮件

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

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 <[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
`

接收邮件

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

[e-mail]

注意：即使您的应用部署在自定义网域中，您也无法接收发送到该网域中地址的电子邮件。

如需接收电子邮件，请执行以下操作：

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 软件包来解析邮件。