gog

核心用法

gog是一个Google Workspace的命令行工具，本Skill提供其完整的使用文档。用户需先完成OAuth认证配置，包括上传client_secret.json文件并添加账户授权。支持六大核心服务：Gmail（搜索/发送邮件）、Calendar（查询事件）、Drive（文件搜索）、Contacts（联系人管理）、Sheets（数据读写/追加/清除）和Docs（导出/查看）。所有命令均支持JSON输出和脚本化操作，通过环境变量GOG_ACCOUNT可简化账户指定。

显著优点

1. 一站式覆盖：单一工具整合Google Workspace全套服务，无需切换多个客户端
2. 自动化友好：支持--json和--no-input参数，便于集成到CI/CD或定时任务
3. 精确操作：Sheets支持单元格级精确读写，Docs支持格式导出，满足数据迁移需求
4. 轻量高效：命令行交互比Web界面更快，适合批量处理和快速查询
5. 文档详尽：提供从安装到高级用法的完整示例，降低学习成本

潜在缺点与局限性

1. 功能边界：Docs仅支持导出和查看，不支持原地编辑复杂文档
2. 依赖外部：Skill本身仅为文档，必须自行安装gog二进制工具才能使用
3. OAuth门槛：需要Google Cloud控制台配置OAuth凭据，对非技术用户有门槛
4. 权限风险：一次授权涉及多个服务，最小权限原则需用户自行把控
5. 无图形反馈：纯CLI交互，不适合需要可视化确认的场景

适合的目标群体

• 开发者/DevOps工程师：需要将Google Workspace集成到自动化工作流
• 数据分析师：批量处理Sheets数据、自动化报表生成
• 系统管理员：批量管理邮件、日历和联系人
• 技术型办公用户：偏好命令行效率，熟悉OAuth配置

使用风险

1. 凭据泄露风险：client_secret.json文件若保管不当可能导致账户被入侵
2. 误操作风险：批量删除/覆盖Sheets数据、误发邮件等操作不可逆
3. 依赖维护风险：gog工具由第三方维护，长期更新和支持存在不确定性
4. API配额限制：Google API有调用频率限制，大规模自动化需考虑限流策略
5. 网络依赖：所有操作需实时连接Google服务，离线场景不可用

核心用法

gog是一款针对Google Workspace服务的命令行工具，通过OAuth认证后可直接在终端操作Gmail、Calendar、Drive、Contacts、Sheets和Docs六大核心服务。

认证流程：首次使用需执行gog auth credentials加载Google OAuth客户端密钥，再通过gog auth add添加账户并授权具体服务范围。

典型场景：

• Gmail批量处理：支持高级搜索语法（如newer_than:7d）筛选邮件，可直接发送邮件
• 日历事件管理：按时间范围导出事件数据，便于生成报告
• 云端硬盘检索：快速定位文件，支持结果数量限制
• 表格自动化：读取、更新、追加、清空单元格数据，支持JSON格式输入输出，适合数据流水线集成
• 文档导出：将Google Docs导出为txt等格式，或直接在终端查看内容

脚本优化：设置GOG_ACCOUNT环境变量避免重复指定账户，配合--json和--no-input参数实现无人值守自动化。

显著优点

• 一体化覆盖：单一工具整合六大Google服务，避免多工具切换
• JSON原生支持：所有数据操作支持结构化输入输出，与现代数据工作流无缝衔接
• Sheets功能完整：CRUD操作齐全，支持USER_ENTERED模式保留公式格式
• brew官方分发：通过steipete/tap维护，安装路径规范
• 文档型Skill零风险：纯Markdown说明文档，无可执行代码

局限与约束

• 依赖外部CLI：实际功能由gog二进制文件提供，Skill本身仅为使用指南
• OAuth配置门槛：需自行创建Google Cloud项目并下载client_secret.json，对非技术用户不够友好
• Docs编辑受限：仅支持导出/查看，无法直接修改文档内容
• T3来源风险：维护者为个人开发者，长期维护稳定性存疑

适合人群

• 需要批量处理Google Workspace数据的数据工程师和运维人员
• 习惯命令行工作流、追求自动化效率的开发者
• 已熟悉OAuth配置流程、具备Google Cloud基础认知的技术用户

常规风险

• OAuth凭证本地存储：gog auth credentials会将敏感信息保存在本地文件系统，共享环境需特别注意权限隔离
• 误操作不可逆：Sheets的clear操作和邮件发送缺乏二次确认，脚本执行前建议加--dry-run逻辑（如工具支持）或充分测试
• 第三方工具信任链：需独立验证gog CLI本身的完整性和更新策略