Goでgmail APIを叩いて下書きを作成する

Go Quickstart  |  Gmail API  |  Google Developers

上記を参考にした。サンプルコードは最後に記載する。実装してる途中でメールの題名に日本語を設定できず、RFC2822について調べる必要があったのでメモしておく。

RFC2822

https://www.ietf.org/rfc/rfc2822.txt

電子メールのフォーマットを定めている。Goのgmailパッケージを使用する際にRFC2822のフォーマットでメッセージを記述する必要があった。基本的なフォーマットは以下の通り。

Header1 CRLF
Header2 CRLF
CRLF
Body

ヘッダーでは:で区切られたヘッダーフィールドとヘッダーボディが記載される。一つのヘッダーの終わりにはCRLFがくる。ヘッダーとボディの間にはCRLFだけの行が入る。この行以降は全てボディである。文字数制限などもあるがここでは省略。具体例は以下の通り。

From: xxxatxxx\r\n
To: yyyatyyy\r\n
Subject: test\r\n
\r\n
test

gmailではボディをHTMLで表現できる。この時、ヘッダにはContent-Type: text/html; charset=UTF-8とコンテンツタイプを設定するといい。

また、RFC2822ではUS-ASCIIを前提としている。ボディ部分に関してはMIMEの導入によりContent-Typeを指定することでUS-ASCII以外を指定できるようになったが、通常だとヘッダ部分は依然としてUS-ASCII以外使用できない。ここに関してだが、RFC2047でヘッダのエンコード仕様が定められている。具体的には、

=?charset?encoding?encoded-text?=

の形式でヘッダをエンコードすることができる(ヘッダでUTF-8の文字が使える！)。概要はこちらを参照。

例えば、題名を「テスト」としたい場合、

=?UTF-8?B?44OG44K544OI?=

となる。文字コード(charset)はUTF-8、エンコードの形式(encoding)はB(base64)、「テスト」をbase64でエンコードした値が44OG44K544OIとなる

これでメールの題名に日本語を設定できるようになる。

サンプルコード

package main

import (
    "encoding/base64"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "log"
    "net/http"
    "net/url"
    "os"
    "os/user"
    "path/filepath"
    "time"

    "golang.org/x/net/context"
    "golang.org/x/oauth2"
    "golang.org/x/oauth2/google"
    "google.golang.org/api/gmail/v1"
)

// getClient uses a Context and Config to retrieve a Token
// then generate a Client. It returns the generated Client.
func getClient(ctx context.Context, config *oauth2.Config) *http.Client {
    cacheFile, err := tokenCacheFile()
    if err != nil {
        log.Fatalf("Unable to get path to cached credential file. %v", err)
    }
    tok, err := tokenFromFile(cacheFile)
    if err != nil {
        tok = getTokenFromWeb(config)
        saveToken(cacheFile, tok)
    }
    return config.Client(ctx, tok)
}

// getTokenFromWeb uses Config to request a Token.
// It returns the retrieved Token.
func getTokenFromWeb(config *oauth2.Config) *oauth2.Token {
    authURL := config.AuthCodeURL("state-token", oauth2.AccessTypeOffline)
    fmt.Printf("Go to the following link in your browser then type the "+
        "authorization code: \n%v\n", authURL)

    var code string
    if _, err := fmt.Scan(&code); err != nil {
        log.Fatalf("Unable to read authorization code %v", err)
    }

    tok, err := config.Exchange(oauth2.NoContext, code)
    if err != nil {
        log.Fatalf("Unable to retrieve token from web %v", err)
    }
    return tok
}

// tokenCacheFile generates credential file path/filename.
// It returns the generated credential path/filename.
func tokenCacheFile() (string, error) {
    usr, err := user.Current()
    if err != nil {
        return "", err
    }
    tokenCacheDir := filepath.Join(usr.HomeDir, ".credentials")
    os.MkdirAll(tokenCacheDir, 0700)
    return filepath.Join(tokenCacheDir,
        url.QueryEscape("gmail-go-quickstart.json")), err
}

// tokenFromFile retrieves a Token from a given file path.
// It returns the retrieved Token and any read error encountered.
func tokenFromFile(file string) (*oauth2.Token, error) {
    f, err := os.Open(file)
    if err != nil {
        return nil, err
    }
    t := &oauth2.Token{}
    err = json.NewDecoder(f).Decode(t)
    defer f.Close()
    return t, err
}

// saveToken uses a file path to create a file and store the
// token in it.
func saveToken(file string, token *oauth2.Token) {
    fmt.Printf("Saving credential file to: %s\n", file)
    f, err := os.OpenFile(file, os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0600)
    if err != nil {
        log.Fatalf("Unable to cache oauth token: %v", err)
    }
    defer f.Close()
    json.NewEncoder(f).Encode(token)
}

func main() {
    log.SetFlags(log.LstdFlags | log.Lshortfile)
    ctx := context.Background()

    b, err := ioutil.ReadFile("client_secret.json")
    if err != nil {
        log.Fatalf("Unable to read client secret file: %v", err)
    }

    // If modifying these scopes, delete your previously saved credentials
    // at ~/.credentials/gmail-go-quickstart.json
    config, err := google.ConfigFromJSON(b, gmail.GmailComposeScope, gmail.GmailModifyScope, gmail.MailGoogleComScope)
    if err != nil {
        log.Fatalf("Unable to parse client secret file to config: %v", err)
    }
    client := getClient(ctx, config)

    srv, err := gmail.New(client)
    if err != nil {
        log.Fatalf("Unable to retrieve gmail Client %v", err)
    }

    now := time.Now()

    const rfc2822 = "Mon Jan 02 15:04:05 -0700 2006"
    emailDate := now.Format(rfc2822)

    subjectStr := fmt.Sprintln("テスト")
    subject := base64.StdEncoding.EncodeToString([]byte(subjectStr))

    message := gmail.Message{
        Raw: base64.URLEncoding.EncodeToString([]byte("Date: " + emailDate + "\r\n" +
            "From: xxxatxxx.xxx\r\n" +
            "To: xxxatxxx.xxx\r\n" +
            "Subject: =?UTF-8?B?" + subject + "?=\r\n" +
            "Content-Type: text/html; charset=UTF-8\r\n" +
            "\r\n" +
            "<html><body>test</body></html>")),
    }

    udSrv := gmail.NewUsersDraftsService(srv)
    if _, err = udSrv.Create("me", &gmail.Draft{Message: &message}).Do(); err != nil {
        log.Fatalln(err)
    }
}

まとめ

RFC2822に関しては実装に必要なとこだけ拾って読んだ程度なのでちゃんと読みたい。