gog

gog 工具为与 Google Workspace 生态系统互动提供了强大的命令行界面。专为高级用户、开发者与自动化工程师设计，简化了 Gmail、Google 日历、云端硬盘、联系人、Google 表格与 Google 文档的互动。通过提供这些服务的程序化存取能力，用户可以绕过网页界面，直接从终端或自动化的代理工作流中执行复杂任务、批量作业与系统整合。

• 执行精细的 Gmail 操作，包括搜索邮件串或个别邮件、发送纯文本或 HTML 邮件、管理草稿以及处理带有邮件串 ID 的回复。

• 管理 Google 日历活动，包含精确的时间规划、创建活动、更新活动细节、设置自定义颜色以及查询特定时间范围内的行程。

• 通过进阶搜索功能简化 Google 云端硬盘的文件操作。

• 在 Google 表格中执行数据密集型操作，例如以 JSON 格式读取单元格范围、执行批量更新、附加新行以及清除特定数据范围。

• 存取并导出 Google 文档内容至本地文件，支持快速检索与文档处理工作流。

• 使用 OAuth 流程简化认证管理，针对各种服务提供安全的跨账户支持。

• 需要使用客户端凭证进行初始 OAuth 设置，并针对每个账户进行明确的服务授权。

• 建议优先使用纯文本邮件以确保兼容性，针对多段落内容可使用 body-file 参数，或使用标准输入 (stdin) 进行管道传输。

• 将 gog 整合至脚本时，建议使用 --json 与 --no-input 旗标，确保输出结果与标准处理工具兼容。

• 利用 GOG_ACCOUNT 等环境变量来维护持续性的账户上下文，减少重复执行指令时所需的参数输入。

• 请注意，Google 文档的复杂原地编辑受 API 限制，建议优先使用导出与读取功能而非直接修改。

• 在部署发送邮件或修改日历活动的自动化脚本前，请确保包含手动确认步骤或进行干运行测试。