メール送信(Python を使用)
1. エグゼクティブサマリー
Python で,SMTP サーバーを使用してメールを送信する方法を説明する。
Python の標準ライブラリ(smtplib,email.mime.text,email.utils)を使用し,SMTP サーバー経由でメールを送信する。単一宛先への送信,複数宛先への一括送信,CC・BCC を指定した送信を扱う。
2. 前準備(必要ソフトウェアの入手)
ここでは、最低限の事前準備について説明する。機械学習や深層学習を行う場合は、NVIDIA CUDA、Visual Studio、Cursorなどを追加でインストールすると便利である。これらについては別ページ https://www.kkaneko.jp/cc/dev/aiassist.htmlで詳しく解説しているので、必要に応じて参照してください。
Python 3.12 のインストール(Windows 上) [クリックして展開]
以下のいずれかの方法で Python 3.12 をインストールする。Python がインストール済みの場合、この手順は不要である。
方法1:winget によるインストール
管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。
winget install --scope machine --id Python.Python.3.12 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_pip=1 Include_test=0 Include_launcher=1 InstallLauncherAllUsers=1"
--scope machine を指定することで、システム全体(全ユーザー向け)にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。
方法2:インストーラーによるインストール
- Python 公式サイト(https://www.python.org/downloads/)にアクセスし、「Download Python 3.x.x」ボタンから Windows 用インストーラーをダウンロードする。
- ダウンロードしたインストーラーを実行する。
- 初期画面の下部に表示される「Add python.exe to PATH」に必ずチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから
pythonコマンドを実行できない。 - 「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。
インストールの確認
コマンドプロンプトで以下を実行する。
python --version
バージョン番号(例:Python 3.12.x)が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。
AIエディタ Windsurf のインストール(Windows 上) [クリックして展開]
Pythonプログラムの編集・実行には、AIエディタの利用を推奨する。ここでは、Windsurfのインストールを説明する。Windsurf がインストール済みの場合、この手順は不要である。
管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。
winget install --scope machine --id Codeium.Windsurf -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --custom "/SP- /SUPPRESSMSGBOXES /NORESTART /CLOSEAPPLICATIONS /DIR=""C:\Program Files\Windsurf"" /MERGETASKS=!runcode,addtopath,associatewithfiles,!desktopicon"
powershell -Command "$env:Path=[System.Environment]::GetEnvironmentVariable('Path','Machine')+';'+[System.Environment]::GetEnvironmentVariable('Path','User'); windsurf --install-extension MS-CEINTL.vscode-language-pack-ja --force; windsurf --install-extension ms-python.python --force; windsurf --install-extension Codeium.windsurfPyright --force"
--scope machine を指定することで、システム全体(全ユーザー向け)にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。
【関連する外部ページ】
Windsurf の公式ページ: https://windsurf.com/
本プログラムが使用する smtplib,email.mime.text,email.utils はすべて Python 標準ライブラリであるため,追加のライブラリインストールは不要である。
3. 実行のための準備とその確認手順(Windows 前提)
3.1 プログラムファイルの準備
第5章のソースコードをテキストエディタ(メモ帳,Windsurf 等)に貼り付け,hoge.py として保存する(文字コード:UTF-8)。
3.2 実行コマンド
コマンドプロンプトでファイルの保存先ディレクトリに移動し,以下を実行する。
python hoge.py
3.3 動作確認チェックリスト
| 確認項目 | 期待される結果 |
|---|---|
| SMTP サーバーへの接続 | 指定した SMTP サーバー(ポート587)に接続し,STARTTLS で暗号化通信が確立される |
| 認証 | 指定したユーザー名・パスワードで SMTP サーバーへのログインが成功する |
| メール送信(単一宛先) | 指定した宛先にメールが送信され,件名・本文・送信日時が正しく設定されている |
| メール送信(複数宛先・CC・BCC) | 複数宛先への一括送信,CC・BCC を指定した送信がそれぞれ正しく動作する |
4. 概要・使い方・実行上の注意
本プログラムは,smtplib を使用して SMTP サーバー経由でメールを送信する。STARTTLS による暗号化通信を行い,ユーザー名とパスワードで認証したうえで送信する。
使用前に,以下の変数を利用環境に合わせて書き換える。
| 変数名 | 設定内容 |
|---|---|
UNAME | SMTP 認証用のユーザー名(メールアドレス) |
PASSWORD | SMTP 認証用のパスワード |
SMTP_SERVER | SMTP サーバーのホスト名 |
FROM_ADDR | 送信元メールアドレス |
TO_ADDR / TO_ADDRS | 宛先メールアドレス(単一は文字列,複数はリスト) |
CC_ADDRS | CC 宛先メールアドレスのリスト |
BCC_ADDRS | BCC 宛先メールアドレスのリスト |
SUBJECT | メールの件名 |
BODY | メールの本文 |
3種類の送信方法を提供する。
単一宛先への送信:mysendmail 関数を使用する。MIMEText でメッセージを構築し,Subject,From,To,Date の各ヘッダを設定して送信する。
複数宛先への一括送信:mysendmail_multiple 関数を使用する。宛先をリストで指定することで,同一内容のメールを複数の宛先へ一括送信できる。sendmail メソッドの第2引数にリストを渡すと,リスト内の全アドレスに送信される。
CC・BCC を指定した送信:mysendmail_cc_bcc 関数を使用する。CC(Carbon Copy)はヘッダに宛先として表示される。BCC(Blind Carbon Copy)はヘッダに記載されないため,他の受信者からは見えない。sendmail メソッドには,To・CC・BCC を含む全受信者のリストを渡す。
ソースコードは第5章に掲載する。
5. ソースコード
5.1 単一宛先への送信
import smtplib
from email.mime.text import MIMEText
from email.utils import formatdate
def mysendmail(uname, password, smtp_server, from_addr, to_addr, subject, body):
msg = MIMEText(body)
msg['Subject'] = subject
msg['From'] = from_addr
msg['To'] = to_addr
msg['Date'] = formatdate()
with smtplib.SMTP(smtp_server, 587) as sv:
sv.starttls()
sv.login(uname, password)
sv.sendmail(from_addr, to_addr, msg.as_string())
UNAME = "user@hoge.com"
PASSWORD = "pass"
SMTP_SERVER = "mailsv.hoge.com"
FROM_ADDR = "user@hoge.com"
TO_ADDR = "other@hoge.com"
SUBJECT = "タイトル"
BODY = "メッセージ本文"
if __name__ == '__main__':
mysendmail(UNAME, PASSWORD, SMTP_SERVER, FROM_ADDR, TO_ADDR, SUBJECT, BODY)
5.2 複数の宛先への一括送信
import smtplib
from email.mime.text import MIMEText
from email.utils import formatdate
def mysendmail_multiple(uname, password, smtp_server, from_addr, to_addrs, subject, body):
msg = MIMEText(body)
msg['Subject'] = subject
msg['From'] = from_addr
msg['To'] = ", ".join(to_addrs)
msg['Date'] = formatdate()
with smtplib.SMTP(smtp_server, 587) as sv:
sv.starttls()
sv.login(uname, password)
sv.sendmail(from_addr, to_addrs, msg.as_string())
UNAME = "user@hoge.com"
PASSWORD = "pass"
SMTP_SERVER = "mailsv.hoge.com"
FROM_ADDR = "user@hoge.com"
TO_ADDRS = ["other1@hoge.com", "other2@hoge.com", "other3@hoge.com"]
SUBJECT = "タイトル"
BODY = "メッセージ本文"
if __name__ == '__main__':
mysendmail_multiple(UNAME, PASSWORD, SMTP_SERVER, FROM_ADDR, TO_ADDRS, SUBJECT, BODY)
5.3 CC・BCC を指定した送信
import smtplib
from email.mime.text import MIMEText
from email.utils import formatdate
def mysendmail_cc_bcc(uname, password, smtp_server, from_addr, to_addr, cc_addrs, bcc_addrs, subject, body):
msg = MIMEText(body)
msg['Subject'] = subject
msg['From'] = from_addr
msg['To'] = to_addr
msg['Cc'] = ", ".join(cc_addrs)
msg['Date'] = formatdate()
all_recipients = [to_addr] + cc_addrs + bcc_addrs
with smtplib.SMTP(smtp_server, 587) as sv:
sv.starttls()
sv.login(uname, password)
sv.sendmail(from_addr, all_recipients, msg.as_string())
UNAME = "user@hoge.com"
PASSWORD = "pass"
SMTP_SERVER = "mailsv.hoge.com"
FROM_ADDR = "user@hoge.com"
TO_ADDR = "other@hoge.com"
CC_ADDRS = ["cc1@hoge.com", "cc2@hoge.com"]
BCC_ADDRS = ["bcc1@hoge.com"]
SUBJECT = "タイトル"
BODY = "メッセージ本文"
if __name__ == '__main__':
mysendmail_cc_bcc(UNAME, PASSWORD, SMTP_SERVER, FROM_ADDR, TO_ADDR, CC_ADDRS, BCC_ADDRS, SUBJECT, BODY)
6. まとめ
smtplib による SMTP 通信
標準ライブラリ smtplib を使用し,SMTP サーバー(ポート587)に接続する。STARTTLS で暗号化通信を行い,with 文で接続の終了処理を自動化する。
MIMEText によるメッセージ構築
MIMEText でメールメッセージを構築し,Subject,From,To,Date の各ヘッダを設定する。as_string() で文字列に変換して送信する。
複数宛先への一括送信
宛先をリストで指定し,sendmail メソッドの第2引数にリストを渡すことで,同一内容のメールを複数の宛先へ一括送信する。
CC・BCC の指定
CC はヘッダに宛先として表示される。BCC はヘッダに記載されないため,他の受信者からは見えない。sendmail メソッドには To・CC・BCC を含む全受信者のリストを渡す。
SMTP 認証
SMTP サーバーへの接続後,ユーザー名とパスワードで login メソッドにより認証を行い,メールを送信する。