什么是Gog
Gog 是一个面向 Google Workspace 的命令行工具，把 Gmail、Google 日历、云端硬盘、通讯录、表格和文档这些常见服务收进同一套 CLI 用法里。对经常在终端里处理事务的开发者、运维或自动化用户来说，它的价值不在于替代各个 Web 界面，而在于把“查”“取”“发”“改”这些高频动作压缩成可组合的命令。比如查最近 7 天邮件、拉取某段时间内的日历事件、搜索云端硬盘文件、读取联系人列表，或直接从表格指定区域读写数据，都可以在同一工具中完成。
从证据看，Gog 的覆盖范围比较明确：Gmail 支持搜索和发送邮件，日历可按时间范围列出事件，Drive 可以按查询条件搜索文件，Contacts 能列出联系人，Sheets 提供读取、更新、追加、清空与元数据查看，Docs 则支持导出、直接读取内容和复制文档。这种设计很适合已经把协作信息沉淀在 Google Workspace 里的团队，因为它不要求用户在多个服务间来回切换，而是让终端成为统一入口。
它的使用前提也很清楚：需要先完成一次 OAuth 配置，导入客户端凭据，再为账号授权相应服务。完成后可以通过环境变量指定默认账号，减少反复传参；如果用于脚本，还可以配合 JSON 输出和无交互参数，便于让 Shell 脚本或其他自动化流程稳定消费结果。需要注意的是，Gog 并不是一个覆盖 Google Docs 全部编辑能力的客户端，文档方面目前更偏向导出、查看和复制，原地编辑仍需要专门的 Docs API 客户端。
核心功能特点
- 一套命令同时操作 Gmail、日历、Drive、通讯录、Sheets 和 Docs，适合把分散的办公动作收敛到终端里
- 支持邮件搜索与发送、日历事件查询、网盘文件搜索等常用操作，覆盖信息获取和日常处理两类需求
- 对 Google Sheets 的支持较完整，既能按范围读取，也能更新、追加、清空单元格，并查看表格元数据
- 可通过 OAuth 完成多服务授权，并用默认账号环境变量减少重复输入，适合长期使用
- 面向脚本场景提供 JSON 输出与无交互调用方式，便于接入批处理、定时任务和命令行流水线
适用场景
如果团队日常工作已经深度依赖 Google Workspace，Gog 最直接的应用场景就是把零散的后台查询做成可复用的命令。例如支持团队值班的人，可以先搜索最近几天的重要邮件，再拉取接下来一周的日历安排，随后在 Drive 中检索相关文档或表格，不必分别打开多个页面查找。对于习惯终端工作的用户，这种流程上的连续性往往比单个功能是否复杂更重要。
它也很适合轻量自动化。证据中明确提到脚本调用建议配合 –json 与 –no-input，这意味着 Gog 可以作为定时任务、CI 辅助脚本或内部工具链的一部分：定期抓取某个表格区域的数据，向表格追加结果，导出文档为文本交给后续处理，或者把 Gmail 搜索结果纳入日报、告警整理和审计记录中。相比直接手写多套 API 调用，统一的 CLI 入口可以降低脚本维护成本，尤其适合先快速搭出流程，再逐步细化。
在个人效率场景里，Gog 更像是一个“终端里的办公遥控器”。例如需要快速查看联系人、搜索某个 Drive 文件、读取 Google Docs 内容，或者从脚本批量更新表格数据时，它都能减少人为点击和切换窗口的时间。不过它也有边界：发邮件和创建事件前需要确认，Docs 不支持在工具内直接做原地编辑，因此更适合查询、导出、同步、批量处理这些偏操作型任务，而不是替代完整的在线编辑体验。