技能介绍

解决的问题

当 Gmail、日历、Drive、通讯录、Sheets、Docs 散落在网页界面里时，批量查询、导出、更新和串联脚本会很不顺。gog 把这些 Google Workspace 操作收敛到一条命令行路径下，适合在终端、CI、自动化流程或 Agent 工作流中调用，而不是靠人工反复点页面。

核心能力与工作方式

技能围绕 OAuth 认证和常用命令组织。使用前需要配置 Google OAuth client secret，并授权指定邮箱访问 Gmail、Calendar、Drive、Contacts、Sheets、Docs 等服务。之后可用命令完成常见操作：Gmail 按条件搜索和发送，Calendar 查询事件，Drive 按关键词搜索，Contacts 列出联系人，Sheets 获取、更新、追加、清除单元格并读取元数据，Docs 导出为文本或直接查看内容。脚本化场景下，优先使用 --json 与 --no-input，Sheets 数据建议通过 --values-json 传入，减少解析歧义。

适用边界

它适合读、查、写表格和导出文档等明确操作，但不是完整 Google API 客户端。Docs 支持导出、查看和复制，原地编辑需要额外接入 Docs API。发送邮件或创建事件前应做确认，避免自动化误触发。设置 GOG_ACCOUNT 可减少重复指定账号，但多账号、权限和 OAuth 配置仍需人工维护。