メール（Gmail OAuth）

OAuth 認証された Gmail API。メッセージ送信、Webhook 受信、バックグラウンドワーカー経由のストリーミング編集に対応します。

🟢 実行時すぐ使える。 OAuth 2.0 デバイスフローを利用した Gmail API です。バックグラウンドの gmail-inbound-daemon ワーカーがスレッドをポーリングし、受信したメッセージをディスパッチしてストリーミングを実現します。

機能概要

Google Cloud Console にアクセスします
新しいプロジェクトを作成します（既存のプロジェクトでも可）
Gmail API を有効にします：
- API とサービスのライブラリで "Gmail API" を検索します
- "Enable" をクリックします
OAuth 2.0 同意画面 を作成します：
- "OAuth consent screen" に移動して作成します
- ユーザータイプは "External" を選択します
- アプリ名、サポートメール、開発者連絡先を入力します
- スコープ https://www.googleapis.com/auth/gmail.modify を追加します
OAuth 2.0 クライアント ID を作成します：
- "Credentials" に移動し、認証情報を作成して OAuth クライアント ID を選択します
- "Desktop app" を選択します
- JSON をダウンロードします（クライアント ID とシークレットが必要になります）

かんたんな方法。 Agent に依頼します：

"connect Gmail to send me notifications using OAuth"

Agent がデバイスフローをガイドし、アクセスを許可します。

手動での設定：

minara auth messaging add email-gmail

またはプロジェクトの .env ファイルに直接記述します：

GMAIL_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
GMAIL_OAUTH_CLIENT_SECRET=your-client-secret
[email protected]

ポーリングの代わりにリアルタイムで返信を受信するには：

GMAIL_PUBSUB_TOPIC=projects/your-project/topics/gmail-notifications

バックグラウンドの gmail-inbound-daemon ワーカーは 30 秒ごとに受信トレイをポーリングし（GMAIL_POLL_INTERVAL_SEC で設定可能）、受信したメッセージをワークフローまたは Agent チャットにディスパッチします。

スレッド処理：返信は元のメッセージを送信したワークフローまたはチャットセッションにルーティングされ、会話履歴が保持されます。

設定後に "Authorization required" と表示される

返信を受信できない

デーモンが稼働しているか確認します。minara learn cron で gmail-inbound-daemon が active と表示されるはずです
Pub/Sub トピックが正しく設定されているか確認します（Webhook を使用する場合）
Agent のログを確認します：tail -f ~/.minara/logs/agent.log | grep gmail