使用 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 套件來剖析郵件訊息。