gog 是一个面向 Google Workspace 的命令行工具（CLI），可用于操作 Gmail、Calendar、Drive、Contacts、Sheets 和 Docs。该工具需要完成 OAuth 授权设置后才能使用。
用途
gog 的用途是通过命令行访问和管理 Google Workspace 中的常见服务，包括邮件、日历、云端硬盘、联系人、表格和文档。它适合在终端中快速查询数据，也适合编写脚本进行批量或自动化操作。
主要能力
根据提供的资料，gog 支持以下服务与操作：
- Gmail：搜索邮件、发送邮件。
- Calendar：查询指定日历的事件。
- Drive：搜索云端硬盘文件。
- Contacts：列出联系人。
- Sheets：读取、更新、追加、清空单元格区域，以及查询表格元数据。
- Docs：导出文档、查看文档内容，并支持复制（copy）；但不支持原位编辑，原位编辑需要 Docs API 客户端。
使用方式
首次使用时需要进行一次性设置，包括指定 OAuth 客户端凭据文件并添加账号：
gog auth credentials /path/to/client_secret.json
gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs
gog auth list
常用命令示例：
- Gmail 搜索：gog gmail search 'newer_than:7d' --max 10
- Gmail 发送：gog gmail send --to a@b.com --subject "Hi" --body "Hello"
- 日历事件：gog calendar events <calendarId> --from <iso> --to <iso>
- Drive 搜索：gog drive search "query" --max 10
- 联系人列表：gog contacts list --max 20
- Sheets 读取：gog sheets get <sheetId> "Tab!A1:D10" --json
- Sheets 更新：gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
- Sheets 追加：gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
- Sheets 清空：gog sheets clear <sheetId> "Tab!A2:Z"
- Sheets 元数据：gog sheets metadata <sheetId> --json
- Docs 导出：gog docs export <docId> --format txt --out /tmp/doc.txt
- Docs 查看：gog docs cat <docId>
其他说明
可以设置环境变量 GOG_ACCOUNT=you@gmail.com 来避免反复传递 --account 参数。
在脚本中使用时，建议使用 --json 配合 --no-input。
Sheets 的单元格值可以通过 --values-json 传递（推荐），也可以使用内联行方式。
Docs 支持 export、cat 和 copy；原位编辑需要 Docs API 客户端，gog 不包含该功能。
在发送邮件或创建事件之前应先进行确认。
适用场景
- 在终端中快速查询 Gmail、Calendar、Drive、Contacts、Sheets 和 Docs 数据。
- 通过脚本批量读取或写入 Google Sheets。
- 自动化发送邮件或查询日历事件。
- 导出或查看 Google Docs 内容。
限制
- 使用前必须完成 OAuth 授权设置。
- Docs 不支持原位编辑，原位编辑需要 Docs API 客户端。
- 发送邮件或创建事件前需要确认。
- 关于收费、价格、平台支持范围等信息，资料中暂未提供。