用途：gog 是 Google Workspace 的命令行界面，用于在终端中操作 Gmail、Calendar、Drive、Contacts、Sheets 和 Docs，适合脚本化与自动化场景。
主要能力：Gmail 支持搜索、按邮件搜索、发送、创建草稿、发送草稿和回复；Calendar 支持列出、创建、更新事件及查看颜色；Drive 支持搜索；Contacts 支持列出；Sheets 支持读取、更新、追加、清空和查看元数据；Docs 支持导出、cat 和复制。
使用方式：首次需运行 gog auth credentials /path/to/client_secret.json，再用 gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets 添加账号，gog auth list 查看。常用命令如 gog gmail search 'newer_than:7d' --max 10、gog gmail send --to a@b.com --subject "Hi" --body "Hello"、gog calendar events <calendarId> --from <iso> --to <iso>、gog drive search "query" --max 10、gog sheets get <sheetId> "Tab!A1:D10" --json。可用 GOG_ACCOUNT 环境变量避免重复传 --account；脚本中建议使用 --json 与 --no-input。
限制：需要 OAuth 设置；Docs 仅支持导出、cat、复制，原地编辑需 Docs API 客户端，不在 gog 内；发送邮件或创建事件前应确认；--body 不会转义 \n，多行内容建议用 --body-file 或 heredoc；gog gmail search 按会话返回一行，需要每封邮件单独返回时用 gog gmail messages search。