APIの有効化

コードを書く前にhttps://gmail.comでGmailアカウントのサインアップが必要です。そして、https://console.cloud.google.comのGoogle Cloudコンソールから、そのアカウントでGmail APIを設定します。これらの手順は第15章で詳しく説明したEZSheetsの設定と同じですので、この章では繰り返しません。新しいプロジェクトを作成し、今回はGoogle Sheets APIではなくGmail APIを有効化します。OAuth同意画面の設定では、https://mail.google.comをスコープに追加して、Pythonスクリプトからメールの送受信ができるようにします。手順を終えると認証情報ファイルとトークンファイルがあるはずです。

対話型シェルで以下のコードを入力してください。

>>> import ezgmail
>>> ezgmail.init()

エラーが発生しなければ、EZGmailが正常にインストールされています。

メールの送信

EZGmailの設定ができたら、関数を1回呼び出すだけでメールの送信ができるはずです。

>>> import ezgmail
>>> ezgmail.send('recipient@example.com', 'Subject line', 'Body of the email')

添付ファイルはsend()関数にリスト引数で指定します。

>>> ezgmail.send('recipient@example.com', 'Subject line', 'Body of the email',
['attachment1.jpg', 'attachment2.mp3'])

セキュリティのアンチスパム機能により、Gmailは同じ本文のメールを繰り返し送れないかもしれませんし（スパムのように見えるからです）、.exeファイルや .zipファイルを添付したメールを送れないかもしれません（ウィルスの可能性があるからです）。

CCやBCCを送信するためにccとbccのオプションのキーワード引数を設定することもできます。

>>> import ezgmail
>>> ezgmail.send('recipient@example.com', 'Subject line', 'Body of the 
email', cc='friend@example.com', bcc='otherfriend@example.com,
someoneelse@example.com')

token.jsonファイルがどのGmailアドレスについて設定したものかを忘れた場合は、ezgmail.EMAIL_ADDRESSで確認できます。

>>> import ezgmail
>>> ezgmail.EMAIL_ADDRESS
'example@gmail.com'

token.jsonファイルはパスワードと同じように取り扱ってください。誰かがこのファイルを入手すると、（Gmailパスワードの変更はできませんが）Gmailアカウントにアクセスできてしまいます。Google Cloudコンソールに戻ってトークンの認証情報を削除すると、token.json ファイルを失効させられます。EZGmailの利用を再開するには、新しい認証情報とトークンファイルの設定をもう一度しなければなりません。

メールの読み取り

Gmailは返信メールのメッセージを会話スレッドにまとめます。ブラウザやアプリでGmailにログインすると、（スレッドに1つのメールしかないとしても）個々のメールではなくメールスレッドが表示されます。

EZGmailには、会話スレッドを表すGmailThreadオブジェクトと、個々のメールを表すGmailMessageオブジェクトがあります。GmailThreadオブジェクトには、GmailMessageオブジェクトのリストを保持しているmessages属性があります。unread()関数は、直近の未読メールのGmailThreadオブジェクトのリストを返します（最大25件）。これをezgmail.summary()に渡せば、そのリストに含まれる会話スレッドの概要を表示します。

>>> import ezgmail
>>> unread_threads = ezgmail.unread()  # GmailThreadオブジェクトのリスト
>>> ezgmail.summary(unread_threads)
Al, Jon - Do you want to watch RoboCop this weekend?- Dec 09
Jon - Thanks for stopping me from buying Bitcoin. - Dec 09

summary()関数はスレッドの要約を手早く表示するのに使えますが、個々のメッセージ（やメッセージの一部）にアクセスするには、GmailThreadオブジェクトのmessages属性を調べます。messages属性には、スレッドを構成するGmailMessageオブジェクトのリストが格納されています。GmailMessageオブジェクトには、そのメールについての詳細を示すsubject、body、timestamp、sender、recipient属性があります。

>>> len(unread_threads)
2
>>> str(unread_threads[0])
"<GmailThread len=2 snippet= Do you want to watch RoboCop this weekend?'>"
>>> len(unread_threads[0].messages)
2
>>> str(unread_threads[0].messages[0])
"<GmailMessage from='Al Sweigart <al@inventwithpython.com>' to='Jon Doe
<example@gmail.com>' timestamp=datetime.datetime(2026, 12, 9, 13, 28, 48)
subject='RoboCop' snippet='Do you want to watch RoboCop this weekend?'>"
>>> unread_threads[0].messages[0].subject
'RoboCop'
>>> unread_threads[0].messages[0].body
'Do you want to watch RoboCop this weekend?\r\n'
>>> unread_threads[0].messages[0].timestamp
datetime.datetime(2026, 12, 9, 13, 28, 48)
>>> unread_threads[0].messages[0].sender
'Al Sweigart <al@inventwithpython.com>'
>>> unread_threads[0].messages[0].recipient
'Jon Doe <example@gmail.com>'

直近25件より多くの未読メールを取得したければ、maxResultsキーワード引数に整数を渡します。例えば、ezgmail.unread(maxResults=50)は直近50件の未読メールを返します。

ezgmail.unread()関数と同様に、ezgmail.recent()関数も直近25件のスレッドを返します。

>>> recent_threads = ezgmail.recent()
>>> len(recent_threads)
25
>>> recent_threads = ezgmail.recent(maxResults=100)
>>> len(recent_threads)
46

オプションのmaxResultsキーワード引数で件数の上限を変更できます。

メールの検索

ezgmail.unread()とezgmail.recent()を使ってメールを取得するだけでなく、ezgmail.search()を使ってメールを検索して取得できます。Gmailの検索ボックスにクエリを入力するのと同じ要領です。

>>> result_threads = ezgmail.search('RoboCop')
>>> len(result_threads)
1
>>> ezgmail.summary(result_threads)
Al, Jon - Do you want to watch RoboCop this weekend? - Dec 09

このsearch()呼び出しは、図20-1に示すように、検索ボックスにRoboCopと入力したのと同じ結果になります。

unread()やrecent()と同様に、search()関数はGmailThreadオブジェクトを返します。search()関数には、以下のような検索ボックスに入力できる特別な検索演算子を渡すことができます。

'label:UNREAD' 未読メール

'from:al@inventwithpython.com' 差出人がal@inventwithpython.comのメール

'subject:hello' 件名に“hello”が含まれるメール

'has:attachment' 添付ファイルのあるメール

https://support.google.com/mail/answer/7190で検索演算子の一覧を確認できます。

添付ファイルのダウンロード

GmailMessageオブジェクトには、そのメッセージに添付されたファイルの名前のリストであるattachments属性があります。GmailMessageオブジェクトのdownloadAttachment()メソッドにその名前を渡せばファイルをダウンロードできます。downloadAllAttachments()ですべてのファイルを一気にダウンロードすることもできます。デフォルトでは、EZGmailは添付ファイルを現在の作業ディレクトリに保存しますが、downloadAttachment()とdownloadAllAttachments()のdownloadFolderキーワード引数に指定すればそのフォルダに保存します。例を示します。

>>> import ezgmail
>>> threads = ezgmail.search('vacation photos')
>>> threads[0].messages[0].attachments
['tulips.jpg', 'canal.jpg', 'bicycles.jpg']
>>> threads[0].messages[0].downloadAttachment('tulips.jpg')
>>> threads[0].messages[0].downloadAllAttachments(downloadFolder='vacation2026')
['tulips.jpg', 'canal.jpg', 'bicycles.jpg']

添付ファイルと同じ名前のファイルがすでに存在すれば、自動的に上書きします。

EZGmailにはここで紹介した以外にもいろいろな機能があります。https://github.com/asweigart/ezgmailでドキュメントを読めます。

プッシュ通知の送信

ntfyウェブサーバーに対してHTTPリクエストを行うだけで、トピックをサブスクライブしている人全員にプッシュ通知を送信できます。これはrequestsライブラリだけで可能です。ntfy固有のパッケージをインストールする必要はありません。

対話型シェルで以下の内容を入力してリクエストを送ってみてください。本章を通じて例に示すAlSweigartZPgxBQ42というトピックはご自身のランダムな秘密のトピックに置き換えてください。

>>> import requests
>>> requests.post('https://ntfy.sh/AlSweigartZPgxBQ42', 'Hello, world!')
<Response [200]>

プッシュ通知を送信するために、requests.post()を呼び出してPOSTのHTTPリクエストを行っています。第13章で紹介したウェブページをダウンロードするrequests.get()関数とは異なります。

トピックAlSweigartZPgxBQ42をサブスクライブしている人は、数秒内に（数分かかることもあります）“Hello, world!”というメッセージを受け取ります。https://ntfy.sh/AlSweigartZPgxBQ42で確認することもできます。