gog
使用 gog 管理 Gmail/日历/云端硬盘/联系人/表格/文档。需要 OAuth 配置。
一次性设置
gog auth credentials /path/to/client_secret.jsongog auth add [email protected] --services gmail,calendar,drive,contacts,docs,sheetsgog auth list
常用命令
- Gmail 搜索：
gog gmail search 'newer_than:7d' --max 10 - Gmail 邮件搜索（按邮箱逐封返回，忽略线程）：
gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account [email protected] - Gmail 发送（纯文本）：
gog gmail send --to [email protected] --subject "Hi" --body "Hello" - Gmail 发送（多行）：
gog gmail send --to [email protected] --subject "Hi" --body-file ./message.txt - Gmail 发送（从标准输入）：
gog gmail send --to [email protected] --subject "Hi" --body-file - - Gmail 发送（HTML）：
gog gmail send --to [email protected] --subject "Hi" --body-html "<p>Hello</p>" - Gmail 草稿：
gog gmail drafts create --to [email protected] --subject "Hi" --body-file ./message.txt - Gmail 发送草稿：
gog gmail drafts send <draftId> - Gmail 回复：
gog gmail send --to [email protected] --subject "Re: Hi" --body "Reply" --reply-to-message-id <msgId> - 日历列出事件：
gog calendar events <calendarId> --from <iso> --to <iso> - 日历创建事件：
gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> - 日历创建事件（带颜色）：
gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7 - 日历更新事件：
gog calendar update <calendarId> <eventId> --summary "New Title" --event-color 4 - 日历显示颜色：
gog calendar colors - 云端硬盘搜索：
gog drive search "query" --max 10 - 联系人：
gog contacts list --max 20 - 表格读取：
gog sheets get <sheetId> "Tab!A1:D10" --json - 表格更新：
gog sheets update <sheetId> "Tab!A1:B2" --values-json '[['"A"','"B"'],['"1"','"2"']]' --input USER_ENTERED - 表格追加：
gog sheets append <sheetId> "Tab!A:C" --values-json '[['"x"','"y"','"z"']]' --insert INSERT_ROWS - 表格清空：
gog sheets clear <sheetId> "Tab!A2:Z" - 表格元数据：
gog sheets metadata <sheetId> --json - 文档导出：
gog docs export <docId> --format txt --out /tmp/doc.txt - 文档查看：
gog docs cat <docId>
日历颜色
- 使用
gog calendar colors查看所有可用的事件颜色（ID 1-11） - 使用
--event-color <id>标志为事件添加颜色 - 事件颜色 ID（来自
gog calendar colors输出）：- 1: #a4bdfc
- 2: #7ae7bf
- 3: #dbadff
- 4: #ff887c
- 5: #fbd75b
- 6: #ffb878
- 7: #46d6db
- 8: #e1e1e1
- 9: #5484ed
- 10: #51b749
- 11: #dc2127
邮件格式
-
优先使用纯文本。对于多段落的邮件，使用
--body-file（或--body-file -从标准输入读取）。 -
草稿和回复同样支持
--body-file模式。 -
--body不会转义\n。如果你需要内联换行，请使用 heredoc 或$'Line 1\n\nLine 2'。 -
仅在需要富文本格式时使用
--body-html。 -
HTML 标签：
<p>用于段落，<br>用于换行，<strong>用于加粗，<em>用于斜体，<a href="url">用于链接，<ul>/<li>用于列表。 -
示例（通过标准输入的纯文本）：
gog gmail send --to [email protected] \ --subject "Meeting Follow-up" \ --body-file - <<'EOF' Hi Name, Thanks for meeting today. Next steps: - Item one - Item two Best regards, Your Name EOF -
示例（HTML 列表）：
gog gmail send --to [email protected] \ --subject "Meeting Follow-up" \ --body-html "<p>Hi Name,</p><p>Thanks for meeting today. Here are the next steps:</p><ul><li>Item one</li><li>Item two</li></ul><p>Best regards,<br>Your Name</p>"
注意事项
- 设置
[email protected]可以避免重复使用--account参数。 - 编写脚本时，建议使用
--json加上--no-input。 - 表格的值可以通过
--values-json（推荐）或内联行传递。 - 文档支持导出/查看/复制。原地编辑需要 Docs API 客户端（本工具不支持）。
- 发送邮件或创建事件前请确认。
gog gmail search按线程返回一行；使用gog gmail messages search可以独立返回每封邮件。