【Python自動化入門④】API連携でGmailやDiscordへ自動通知させる方法

はじめに：今回のテーマについて

こんにちは！「Python自動化入門」連載も第4回を迎えました。これまでの記事では、ファイル操作やスケジュール実行など、Pythonを使った基本的な自動化の仕組みを学んできました。

今回のテーマは「API連携による自動通知」です。プログラムの処理結果やエラー情報を、GmailやDiscordに自動で送信できるようになると、わざわざパソコンの前で結果を確認する必要がなくなります。外出中でもスマホで通知を受け取れるので、業務効率が大きく向上します。

この記事では、Pythonの基本文法がわかる方を対象に、Gmail・Discordへの自動通知の実装方法を、初心者にもわかりやすく丁寧に解説していきます。

なぜ「自動通知」が便利なのか

まずは自動通知を導入するメリットについて整理しておきましょう。

常にパソコンを監視しなくてよくなる

定期実行しているスクリプトが正常に終了したか、エラーが出ていないかを、いちいちログファイルを開いて確認するのは大変です。通知機能があれば、結果が届いた時点で内容を確認するだけで済みます。

チームやコミュニティで情報共有ができる

Discordの通知機能を使えば、処理結果をチームのチャンネルに自動投稿できます。複数人で開発している場合、誰かが状況を確認するたびに手動で報告する手間が省けます。

活用シーンの例

• スクレイピング処理が完了したらGmailで結果を送る
• サーバーの死活監視でエラーが出たらDiscordに即時通知する
• 毎朝の天気予報やニュースを自動でDiscordに配信する

Gmailを使った自動メール送信

まずはGmailを使ったメール自動送信の方法を見ていきましょう。ここでは初心者でも扱いやすい「アプリパスワード」を使ったSMTP経由の方法を紹介します。

事前準備：Googleアプリパスワードの取得

Gmailはセキュリティ上、通常のパスワードでは外部からのログインを許可していません。そのため、以下の手順で「アプリパスワード」を発行する必要があります。

• Googleアカウントの「セキュリティ」設定画面を開く
• 「2段階認証プロセス」を有効にする
• 「アプリパスワード」を選択し、新しいパスワードを生成する

生成された16桁のパスワードは、後ほどPythonコード内で使用します。

Pythonでメールを送信するコード

標準ライブラリのsmtplibとemailモジュールを使うと、追加のインストールなしでメール送信ができます。

import smtplib
from email.mime.text import MIMEText

def send_gmail(subject, body, to_address):
    from_address = "your_gmail@gmail.com"
    app_password = "発行したアプリパスワード"

    msg = MIMEText(body)
    msg["Subject"] = subject
    msg["From"] = from_address
    msg["To"] = to_address

    with smtplib.SMTP("smtp.gmail.com", 587) as server:
        server.starttls()
        server.login(from_address, app_password)
        server.send_message(msg)

    print("メール送信が完了しました")

# 実行例
send_gmail("処理完了のお知らせ", "スクリプトの実行が正常に終了しました。", "宛先メールアドレス")

このコードでは、件名（subject）、本文（body）、宛先（to_address）を指定するだけで、簡単にメールを送信できます。パスワードなどの機密情報は、実際の運用では環境変数や設定ファイルに分離することをおすすめします。

Discordへの自動通知

次に、チーム開発や個人のコミュニティでもよく使われるDiscordへの通知方法を紹介します。DiscordはWebhookという仕組みを使うことで、非常に簡単に外部からメッセージを送信できます。

Webhook URLの取得方法

まずはDiscord側でWebhookを設定します。

• 通知を送りたいチャンネルの設定画面を開く
• 「連携サービス」→「ウェブフックを作成」を選択
• Webhook名を設定し、「ウェブフックURLをコピー」をクリック

このURLに対してPOSTリクエストを送るだけで、メッセージを投稿できます。

Pythonで通知を送るコード

Discordへの通知には、外部ライブラリのrequestsを使用します。まだインストールしていない方は、以下のコマンドで導入してください。

pip install requests

続いて、実際に通知を送るコードです。

import requests

def send_discord_notification(message):
    webhook_url = "コピーしたWebhook URL"
    data = {
        "content": message
    }
    response = requests.post(webhook_url, json=data)

    if response.status_code == 204:
        print("Discordへの通知が完了しました")
    else:
        print(f"通知の送信に失敗しました：{response.status_code}")

# 実行例
send_discord_notification("スクリプトの実行が正常に終了しました。")

たったこれだけのコードで、Discordのチャンネルに自動でメッセージを投稿できます。Gmailに比べて設定も簡単なので、まずはDiscordから試してみるのもおすすめです。

安定して運用するためのポイント

自動通知の仕組みを実際に運用する際には、いくつか気をつけたいポイントがあります。

エラーハンドリングを忘れずに

通知処理自体でエラーが発生すると、本来の処理結果すら把握できなくなってしまいます。try-except文を使って、通知送信の失敗にも対応できるようにしておきましょう。

try:
    send_gmail("処理完了", "正常終了しました", "宛先アドレス")
except Exception as e:
    print(f"通知の送信中にエラーが発生しました：{e}")

機密情報の管理に注意する

アプリパスワードやWebhook URLは、他人に知られると悪用される可能性があります。コード内に直接書くのではなく、.envファイルや環境変数を使って管理することを強くおすすめします。

定期実行と組み合わせる

これまでの連載で紹介したスケジュール実行（例：scheduleライブラリやタスクスケジューラ）と組み合わせることで、「毎日決まった時間に処理を実行し、結果を自動通知する」という一連の自動化フローが完成します。

まとめ

今回は、PythonからGmailやDiscordへ自動通知を送る方法について解説しました。

• Gmailはsmtplibを使ったSMTP経由の送信が手軽
• DiscordはrequestsとWebhookを使うことで簡単に通知できる
• 機密情報の管理やエラーハンドリングも忘れずに行う

自動通知の仕組みを取り入れることで、日々の作業確認の手間が大きく減り、より快適な自動化環境を構築できます。次回の連載では、これらの技術を組み合わせた実践的な自動化プロジェクトの作り方を紹介予定です。ぜひ楽しみにしていてください。