Google Workspace

通过命令行自动化操作 Gmail、Google Calendar、Google Drive 和 Google Sheets。支持读取与发送邮件、创建日历事件、管理 Drive 文件，以及读写 Sheets 数据 —— 全部基于 Google API Python 客户端，并使用服务账号认证。

配置

选项 1：服务账号（推荐用于自动化场景）

export GOOGLE_SERVICE_ACCOUNT_JSON='{"type":"service_account","project_id":"...","private_key_id":"...","private_key":"-----BEGIN RSA PRIVATE KEY-----n...","client_email":"...@....iam.gserviceaccount.com","client_id":"...","auth_uri":"https://accounts.google.com/o/oauth2/auth","token_uri":"https://oauth2.googleapis.com/token"}'

创建路径：Google Cloud Console → IAM → 服务账号 → 创建 → 添加 JSON 密钥。
随后启用以下 API：Gmail API、Calendar API、Drive API、Sheets API。
对于 Gmail / Calendar / Drive：需在 Google Workspace 管理控制台中启用全域委托（domain-wide delegation），并添加相应权限范围（scopes）。

选项 2：OAuth 凭据文件

export GOOGLE_CREDENTIALS_FILE="/path/to/credentials.json"
export GOOGLE_TOKEN_FILE="/path/to/token.json"   # 首次运行时自动生成

命令 / 使用方法

# ── GMAIL ───────────────────────────────────────────────
# 读取收件箱（最新 10 封邮件）
python3 scripts/google_workspace.py gmail-inbox
python3 scripts/google_workspace.py gmail-inbox --limit 25

# 搜索邮件
python3 scripts/google_workspace.py gmail-search --query "from:boss@company.com subject:urgent"
python3 scripts/google_workspace.py gmail-search --query "is:unread" --limit 20

# 发送邮件
python3 scripts/google_workspace.py gmail-send --to "client@example.com" --subject "Meeting Tomorrow" --body "Hi, just confirming our meeting at 2pm."
python3 scripts/google_workspace.py gmail-send --to "a@x.com" --subject "Report" --body "See attached." --attachment "/path/to/report.pdf"

# 为邮件添加标签
python3 scripts/google_workspace.py gmail-label --message-id "18abc123..." --label "Important"

# 创建草稿
python3 scripts/google_workspace.py gmail-draft --to "client@example.com" --subject "Draft Subject" --body "Draft content here."

# ── CALENDAR ────────────────────────────────────────────
# 列出即将发生的日程事件
python3 scripts/google_workspace.py cal-list
python3 scripts/google_workspace.py cal-list --days 14 --limit 20

# 创建日程事件
python3 scripts/google_workspace.py cal-create --title "Team Standup" --start "2024-03-15T09:00:00" --end "2024-03-15T09:30:00" --timezone "Australia/Brisbane"
python3 scripts/google_workspace.py cal-create --title "All Day Event" --start "2024-03-20" --all-day

# 更新日程事件
python3 scripts/google_workspace.py cal-update --event-id "abc123..." --title "Updated Title" --start "2024-03-15T10:00:00" --end "2024-03-15T10:30:00"

# 删除日程事件
python3 scripts/google_workspace.py cal-delete --event-id "abc123..."

# ── DRIVE ───────────────────────────────────────────────
# 列出文件
python3 scripts/google_workspace.py drive-list
python3 scripts/google_workspace.py drive-list --query "name contains 'report'" --limit 20

# 上传文件
python3 scripts/google_workspace.py drive-upload --file ./report.pdf
python3 scripts/google_workspace.py drive-upload --file ./report.pdf --folder-id "1BxiMVs0XRA5..."

# 下载文件
python3 scripts/google_workspace.py drive-download --file-id "1BxiMVs0XRA5..." --output ./downloaded.pdf

# 分享文件
python3 scripts/google_workspace.py drive-share --file-id "1BxiMVs0XRA5..." --email "colleague@company.com" --role writer
python3 scripts/google_workspace.py drive-share --file-id "1BxiMVs0XRA5..." --anyone-link

# ── SHEETS ──────────────────────────────────────────────
# 读取指定区域数据
python3 scripts/google_workspace.py sheets-read --spreadsheet-id "1BxiMVs0XRA5..." --range "Sheet1!A1:D10"

# 向指定区域写入数据
python3 scripts/google_workspace.py sheets-write --spreadsheet-id "1BxiMVs0XRA5..." --range "Sheet1!A1" --values '[["Name","Score"],["Alice",95],["Bob",87]]'

# 追加一行数据
python3 scripts/google_workspace.py sheets-append --spreadsheet-id "1BxiMVs0XRA5..." --range "Sheet1!A:D" --values '["John","Doe","john@example.com",42]'

依赖要求

• Python 3.8+
• google-api-python-client（执行 pip install google-api-python-client google-auth google-auth-httplib2 安装）
• GOOGLE_SERVICE_ACCOUNT_JSON 环境变量（或 OAuth 凭据）