Gog Google Workspace 命令行工具

问题

处理 Gmail、Calendar、Drive、Sheets、Docs 时，脚本常要分别处理 OAuth token、API endpoint 和参数格式。人工复制邮件正文、表格片段或日程信息容易出错，也不方便接入自动化。

工作方式

• 授权：先完成一次性 OAuth 配置，再按账户和服务访问 Google Workspace。
• 查询：gmail search 可按 newer_than:7d 等条件取邮件；calendar events 查日程；drive search 找文件；contacts list 列联系人。
• 读写：sheets get、sheets update、sheets append、sheets clear、sheets metadata 处理表格区域；docs export 与 docs cat 读取文档内容。

脚本化时建议显式使用 --json 和 --no-input，并用 GOG_ACCOUNT 避免重复指定账户。对 Sheets 写入，优先用 --values-json 传结构化值，而不是拼接行内文本。

边界

它适合查询、读取、导出和轻量更新，不适合复杂 Docs 原地编辑；文档编辑需要额外接入 Docs API 客户端。发送邮件或创建日程前，应在业务层加入确认逻辑。