gog¶

Skill 简介¶

gog 是一个功能强大的命令行界面（CLI）工具，旨在简化开发者与 Google Workspace 的交互。它支持 Gmail、Google Calendar、Google Drive、Google Contacts、Google Sheets 和 Google Docs 等核心服务的操作。通过 gog，开发者可以轻松地在终端中执行各种任务，例如管理邮件、日历事件、文件、联系人、电子表格和文档，而无需依赖图形用户界面。

对于那些需要频繁与 Google Workspace 进行交互的开发者来说，gog 提供了一个高效、灵活的解决方案。它通过命令行方式将常用的 Google 服务功能整合在一起，节省了开发时间并提高了工作效率。此外，gog 支持 OAuth 认证，确保用户数据的安全性和隐私性。

主要功能¶

gog 提供了丰富的功能，以下是其中几个核心功能的详细介绍：

Gmail 操作：
gog 支持对 Gmail 的全面操作，包括搜索邮件、发送邮件、创建草稿和回复邮件等。例如，可以使用以下命令搜索过去 7 天内的邮件：
bash gog gmail search 'newer_than:7d' --max 10
发送邮件时，gog 支持纯文本、HTML 和多行文本格式，满足不同需求。
Google Calendar 管理：
通过 gog，开发者可以列出日历事件、创建新事件以及更新现有事件。例如，创建带有颜色的事件：
bash gog calendar create <calendarId> --summary "会议" --from "2023-10-01T10:00:00Z" --to "2023-10-01T11:00:00Z" --event-color 7
使用 gog calendar colors 命令可以查看所有可用的事件颜色。
Google Drive 搜索：
gog 允许开发者搜索 Google Drive 中的文件。例如，搜索包含特定关键词的文件：
bash gog drive search "项目计划" --max 10
这对于需要快速查找文件的场景非常有用。
Google Contacts 管理：
开发者可以使用 gog 列出联系人。例如，列出前 20 个联系人：
bash gog contacts list --max 20
这对于需要批量处理联系人信息的场景非常方便。
Google Sheets 操作：
gog 支持获取、更新、追加和清除 Google Sheets 中的数据。例如，获取特定范围内的数据：
bash gog sheets get <sheetId> "Sheet1!A1:D10" --json
这对于需要与电子表格进行数据交互的应用非常有用。
Google Docs 操作：
gog 支持导出和查看 Google Docs 文档。例如，导出文档为文本文件：
bash gog docs export <docId> --format txt --out /tmp/document.txt
这对于需要将文档内容集成到其他工具中的场景非常方便。

使用场景¶

自动化任务：
在开发过程中，开发者可能需要定期执行一些重复性任务，例如发送通知邮件、更新电子表格或管理日历事件。gog 可以通过脚本化方式实现这些任务的自动化，提高工作效率。
数据同步与备份：
开发者可以使用 gog 将 Google Drive 中的文件同步到本地服务器，或将 Google Contacts 的数据备份到本地数据库。这对于数据安全和业务连续性非常重要。
集成开发：
在开发需要与 Google Workspace 集成的应用时，gog 可以作为中间层，简化与 Google 服务的交互。例如，开发一个内部管理系统，需要从 Google Sheets 获取数据，或将数据写入 Google Docs。
团队协作：
团队成员可以使用 gog 管理和共享日历事件、联系人信息和文件资源，促进团队协作。例如，创建一个共享日历事件：
bash gog calendar create <calendarId> --summary "团队会议" --from "2023-10-01T10:00:00Z" --to "2023-10-01T11:00:00Z" --event-color 4
数据分析与处理：
开发者可以使用 gog 获取 Google Sheets 中的数据，进行数据分析或处理，然后将结果写回电子表格。例如，获取特定范围内的数据并进行处理：
bash gog sheets get <sheetId> "Sheet1!A1:D10" --json | python process_data.py

如何使用¶

安装¶

gog 可以通过 Homebrew 安装：

brew install steipete/tap/gogcli

配置¶

在使用 gog 之前，需要进行 OAuth 认证：

gog auth credentials /path/to/client_secret.json
gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets
gog auth list

前置条件¶

需要一个 Google 账户，并启用 Google Workspace API。
需要在 Google Cloud Console 中创建 OAuth 客户端凭证，并下载 client_secret.json 文件。

示例¶

示例 1：发送邮件¶

以下示例展示了如何使用 gog 发送一封纯文本邮件：

gog gmail send --to recipient@example.com \
  --subject "会议跟进" \
  --body-file - <<'EOF'
你好，

感谢今天的会议。接下来需要完成的任务：
- 任务一
- 任务二

此致，
你的名字
EOF

示例 2：创建日历事件¶

以下示例展示了如何创建一个带有颜色的日历事件：

gog calendar create <calendarId> --summary "团队会议" --from "2023-10-01T10:00:00Z" --to "2023-10-01T11:00:00Z" --event-color 7

总结¶

gog 是一个功能强大且灵活的 Google Workspace CLI 工具，适用于需要频繁与 Google 服务交互的开发者。通过 gog，开发者可以高效地执行各种任务，例如管理邮件、日历事件、文件、联系人、电子表格和文档。gog 的命令行方式使其非常适合自动化和集成开发场景，提高了工作效率。对于那些希望简化与 Google Workspace 交互的开发者来说，gog 是一个不可或缺的工具。

gog