Gmail 收件匣管理
目標
使用統一工具跨多個 Gmail 帳戶檢查與管理電子郵件。
腳本
./scripts/gmail_unified.py- 檢查與管理收件匣./scripts/gmail_multi_auth.py- 認證帳戶./scripts/gmail_bulk_label.py- 大量標籤處理./scripts/gmail_create_filters.py- 建立篩選器./scripts/gmail_auth.py- 認證輔助
快速參考
# 檢查所有帳戶的未讀郵件
python3 ./scripts/gmail_unified.py --query "is:unread" --limit 50
# 僅檢查特定帳戶
python3 ./scripts/gmail_unified.py --query "is:unread" --account yourcompany
# 列出已註冊的帳戶
python3 ./scripts/gmail_unified.py --accounts
# 為郵件加上標籤並封存
python3 ./scripts/gmail_unified.py --query "from:notifications@" --label "Notifications" --archive
# 標記為已讀
python3 ./scripts/gmail_unified.py --query "from:noreply@" --mark-read
# 預覽模式(不實際執行)
python3 ./scripts/gmail_unified.py --query "subject:invoice" --label "Invoices" --dry-run
帳戶註冊表
| 帳戶名稱 | 電子郵件 | 憑證 | Token |
|---|---|---|---|
| youruser | [email protected] | credentials.json | token_youruser.json |
| yourcompany | [email protected] | credentials_yourcompany.json | token_yourcompany.json |
認證錯誤排錯
「找不到 Token 檔案」
python3 ./scripts/gmail_multi_auth.py --account yourcompany --email [email protected]
「invalid_scope: Bad Request」
rm token_youruser.json
python3 ./scripts/gmail_multi_auth.py --account youruser --email [email protected]
「認證失敗」
請確認 credentials.json 存在於專案根目錄中。
必要權限範圍
gmail.modify- 讀取/寫入電子郵件gmail.labels- 建立/管理標籤gmail.settings.basic- 管理設定spreadsheets- Google Sheets 存取權drive- Google Drive 存取權
憑證存放位置
所有憑證檔案應位於工作區根目錄:
credentials.json/credentials_yourcompany.json- OAuth 用戶端設定token_*.json- 認證 token(自動產生)gmail_accounts.json- 帳戶註冊表
架構
輸入
| 名稱 | 類型 | 必要 | 說明 |
|---|---|---|---|
query | string | 否 | Gmail 搜尋查詢(例如 'is:unread') |
account | string | 否 | 註冊表中的特定帳戶名稱 |
limit | integer | 否 | 最大擷取郵件數量(預設:50) |
輸出
| 名稱 | 類型 | 說明 |
|---|---|---|
emails | array | 郵件物件列表,包含主旨、寄件人、日期、摘要 |
憑證
| 名稱 | 來源 |
|---|---|
credentials.json | 檔案 |
token_*.json | 檔案(自動產生) |
可組合技能
與此技能良好搭配的技能有:gmail-label、instantly-autoreply
費用
免費(Gmail API)