gog 是一个 Google Workspace 命令行工具（CLI），版本 v0.10.0，用于在终端中操作 Gmail、Calendar、Drive、Sheets、Docs、Contacts 和 Tasks 等 Google 服务。资料中给出的默认账号为 your-account@gmail.com，执行路径为 gog。
用途
gog 面向需要在命令行或自动化流程中操作 Google Workspace 的场景。资料中列出的触发示例包括「发邮件」「查看日历」「上传到 Drive」「创建表格」「搜索联系人」「添加任务」等。
主要能力
Gmail：支持邮件搜索（如 from、is:unread、subject、has:attachment、after、label 等查询条件）、获取消息与正文、下载附件、发送邮件（支持 --to、--cc、--bcc、--subject、--body、--body-html、--body-file、--attach、--thread-id、--reply-to-message-id、--reply-all）、查看标签列表以及为会话添加或移除标签。
Calendar：支持查看未来或指定时间段的事件、按日历查看、创建事件（支持标题、起止时间、全天、地点、描述、参与者、Google Meet、提醒、重复规则）、更新、删除、搜索事件以及列出日历。
Drive：支持列出文件、按父文件夹或数量限制查看、搜索文件、下载与上传文件、创建文件夹、移动、重命名、复制、共享（reader/writer 角色）、查看权限以及取消共享。
Sheets：支持读取单元格区域、写入单元格（管道分隔或 JSON 格式）、在末尾追加行、清除区域、设置格式（如背景色、加粗）、创建与复制表格、查看元数据以及导出为 CSV 或 XLSX。
Contacts：支持列出、搜索、获取、创建、更新和删除联系人。
Tasks：支持列出任务列表、查看任务、创建任务（可带备注与截止日期）、标记完成、恢复未完成、更新、删除以及清除已完成任务。
使用方式
通过命令行执行 gog 子命令，例如 gog gmail search、gog calendar events、gog drive upload、gog sheets get、gog contacts search、gog tasks add 等。资料提示在使用 exec 工具执行时指定 timeout: 60，以等待 API 响应；获取长列表时可用 --max 限制数量。通用选项包括 --json（JSON 输出）、--plain（TSV 输出）、-a/--account（指定账号）、--max（最大件数）、--force（跳过确认）、-n/--dry-run（预览而不执行）。
适用场景
适合在终端中快速完成邮件收发、日历管理、云盘文件操作、表格读写、联系人维护和任务管理等日常办公事务，也适合将这些操作嵌入脚本或自动化流程。
限制
资料未提供 gog 的安装方式、授权配置步骤、收费与价格信息、支持平台范围以及具体性能或效果说明，这些内容暂未提供。部分命令依赖从 URL 中获取的 ID（如 SpreadsheetId、FileId），CalendarId 可使用 primary 或共享日历邮箱，TasklistId 可通过 gog tasks lists list 查看。