核心用法
gog 是一款针对 Google Workspace 的命令行工具，支持 Gmail、Calendar、Drive、Contacts、Sheets、Docs 六大核心服务。用户需先完成 OAuth 认证配置，包括上传 client_secret.json 并授权指定服务，之后即可通过简洁的命令语法执行批量操作。
Gmail 模块：支持高级搜索语法（如 newer_than:7d）、邮件发送（需确认），适合批量筛选和自动化邮件处理。
Calendar 模块：可按时间范围导出事件，便于日程数据分析或迁移。
Drive 模块：提供文件搜索功能，支持结果数量限制。
Contacts 模块：支持联系人列表导出，便于 CRM 同步或备份。
Sheets 模块：功能最为完善，涵盖数据读取、更新、追加、清除及元数据获取，支持 JSON 格式输入输出，适合数据管道集成。
Docs 模块：支持导出为多种格式（如 txt）和直接查看内容，但不支持原地编辑。
显著优点
- 全终端操作：无需打开浏览器即可完成复杂 Workspace 任务，极大提升效率。
- 脚本友好：提供
--json输出和--no-input选项，便于与 CI/CD、数据处理流程集成。 - 单工具覆盖多服务：一个二进制文件统一管理六大 Google 服务，降低学习成本。
- Sheets 操作精细：支持范围级别的读写、追加、清除，数据处理能力接近专用 API 客户端。
潜在缺点与局限性
- OAuth 配置门槛：首次使用需完成 Google Cloud Console 项目创建、凭据下载、多步授权，对非技术用户不够友好。
- Docs 编辑受限：无法直接修改文档内容，复杂编辑仍需借助官方 API 或其他工具。
- 依赖外部服务：所有操作均需调用 Google API，受网络条件和 API 配额限制。
- 安全风险：OAuth 凭据和 refresh token 的本地存储需用户自行保障安全。
适合人群
- 开发者与 DevOps 工程师，需自动化 Workspace 数据流程
- 数据分析师，需批量导出 Sheets/Calendar 数据
- 系统管理员，需批量管理联系人或邮件
- 追求效率的高级 Google Workspace 用户
常规风险
- OAuth 凭据泄露：client_secret.json 文件若被窃取，攻击者可冒充应用获取用户数据
- 误操作风险：批量删除 Sheets 数据或发送邮件前需仔细确认，建议先在测试环境验证
- API 配额超限：高频自动化任务可能触发 Google API 限流
- 账号安全：建议启用 Gmail 发送确认提示，避免脚本误发邮件