Mail API を使用したメールの送受信

このガイドでは、Mail API を使用してメールを送受信する方法について説明します。

この API は第 1 世代ランタイムでサポートされており、対応する第 2 世代ランタイムへのアップグレード時に使用できます。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 パッケージを使用すると、メール メッセージを解析できます。