Gmail PDF Unlocker

About this Project

メールし、設定した条件のメールであれば、添付ファイルのPDFをパスワードを解除してGoogleドライブに保存する、というプロジェクトです。

System Configuration & Workflow

GCE の e2-micro インスタンスを利用することで、実質無料で常時運用が可能です。※1

• Gmail API: 特定の送信元から届く未読メールを検索・取得。
• Python (pypdf): メモリ上で安全にPDFのパスワードを解除。
• Google Drive API: 指定したフォルダへ自動的に保存。

Setup

1. GCP プロジェクトの設定

1. Gmail API と Google Drive API を有効化。
2. OAuth 同意画面を設定し、デスクトップアプリとして「OAuth クライアント ID」を作成。
3. credentials.json を取得。

2. インストールと配置

git clone <your-repo-url>
cd unlockpdf
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Usage

初回実行（認証）

初回実行時はブラウザが立ち上がり、Googleアカウントへのログインが求められます。認証が完了すると、作業ディレクトリに token.json が生成されます。

python unlock_and_save.py

サービス化 (systemd)

24時間365日、常時稼働させるために Linux の systemd を使用してバックグラウンドプロセスとして登録します。これにより、プログラムの異常終了時やサーバー再起動時にも自動で復帰します。

# /etc/systemd/system/unlockpdf.service
[Service]
ExecStart=/path/to/venv/bin/python /path/to/unlock_and_save.py
Restart=always
User=your-user-name

Deployment (Google Compute Engine)

コストを最適化(最小化)するため、GCE の無料枠（e2-micro）での運用します。

1. インスタンス作成: 無料枠対象リージョン（us-west1, us-central1 など）で e2-micro を作成。
(⚠️私は f1-microで 作成してしまい、課金が発生してしまいました。料金計算は数時間遅れるため、停止後もしばらくは料金が 増加します）
2. ファイルの転送: unlock_and_save.py, credentials.json, token.json をアップロード。

   ※ サーバーはGUIがないため、ローカル環境で生成した token.json を転送する必要があります。

3. 常時稼働の設定: systemd ユニットファイルを作成し、サービスを有効化（enable/start）します。

Security Considerations

Video Demo

Development Environment

• Google Compute Engine
• Python 3.x
• Gmail & Drive API
• pypdf

Precautions & Resources

Google Cloud Platformの料金にご注意ください。無料枠（e2-micro）の範囲外で運用すると課金が発生します。

資料はGitHubで公開しています。個人の学習や小規模なプロジェクトでの再利用を歓迎します。

Best Practices for 24/7 Operation

[Service]
Restart=always
RestartSec=5
ExecStart=/path/to/venv/bin/python main.py