用途：gog 是 Google Workspace 的命令行接口，面向智能体与自动化场景，用终端命令操作 Gmail、Calendar、Drive、Contacts、Tasks、Sheets、Docs、Slides、Forms、Chat 等。
主要能力：Gmail 支持搜索线程与消息（含正文）、读取线程、发送邮件、管理标签；Calendar 支持查看今日/本周/未来数天事件、跨日历查询、搜索、创建事件、查询空闲时间、列出日历；Drive 支持列出、搜索、上传、下载、新建文件夹；Tasks 支持列出任务列表与任务、添加、标记完成；Contacts 支持搜索与列出；Sheets 支持读取元数据、读取区域、更新与追加数据；Docs 与 Slides 支持读取文本与导出 PDF；Chat 支持列出空间、读取消息、发送私信（仅 Workspace）。
使用方式：每个命令都需设置环境变量 GOG_ACCOUNT 与 GOG_KEYRING_PASSWORD，后者需从 agent-secrets 租用。解析结果时建议始终加 --json；也可用 --plain 输出稳定 TSV，或默认人类可读表格。错误与进度输出到 stderr，可用 jq 过滤 JSON。首次使用需执行 gog auth add <email> --services user 完成浏览器 OAuth，再用 gog auth list --check 验证。
适用场景：批量搜索并汇总未读邮件、查找下一个空闲时段、生成今日议程、脚本化操作表格与文档等。
限制：Chat 功能仅限 Workspace 账户；缺少密钥环密码会报 Secret not found；未授权服务会报 No auth；权限不足需用 --force-consent 重新授权；系统使用文件后端密钥环，需设置 GOG_KEYRING_PASSWORD。