gog

gog

使用 gog 操作 Gmail/日历/云端硬盘/通讯录/表格/文档。需要 OAuth 设置。

一次性设置

• gog auth credentials /path/to/client_secret.json
• gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets
• gog auth list

常用命令

• Gmail 搜索：gog gmail search 'newer_than:7d' --max 10
• Gmail 邮件搜索（按邮件，忽略线程）：gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com
• Gmail 发送（纯文本）：gog gmail send --to a@b.com --subject "Hi" --body "Hello"
• Gmail 发送（多行）：gog gmail send --to a@b.com --subject "Hi" --body-file ./message.txt
• Gmail 发送（标准输入）：gog gmail send --to a@b.com --subject "Hi" --body-file -
• Gmail 发送（HTML）：gog gmail send --to a@b.com --subject "Hi" --body-html "<p>Hello</p>"
• Gmail 草稿：gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt
• Gmail 发送草稿：gog gmail drafts send <draftId>
• Gmail 回复：gog gmail send --to a@b.com --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 recipient@example.com \
    --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 recipient@example.com \
    --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>"
  

注意事项

• 设置 GOG_ACCOUNT=you@gmail.com 以避免重复使用 --account。
• 对于脚本编写，建议使用 --json 加上 --no-input。
• 表格值可以通过 --values-json（推荐）或内联行传递。
• 文档支持导出/查看/复制。原地编辑需要 Docs API 客户端（不在 gog 中）。
• 发送邮件或创建事件前请确认。
• gog gmail search 每个线程返回一行；当需要每个单独邮件分别返回时，使用 gog gmail messages search。