Auto-sync: 2026-04-21 16:03

wiki/entities/gog-CLI.md

@@ -0,0 +1,64 @@
+---
+title: "gog CLI"
+type: entity
+tags: [cli, google-workspace, oauth, automation]
+---
+
+## Aliases
+- gogcli
+- gog CLI
+
+## Definition
+gog CLI 是由 steipete 开发并维护的 macOS 命令行工具，通过 Google OAuth API 实现对 Google Workspace（Gmail、Google Calendar、Google Drive、Google Contacts、Google Docs、Google Sheets）的命令行管理。
+
+## Installation
+```bash
+brew install steipete/tap/gogcli
+# 验证安装
+which gog
+# 输出: /opt/homebrew/bin/gog
+```
+
+## Core Services Supported
+| 服务 | 主要命令 |
+|------|---------|
+| Gmail | `gog gmail search`, `gog gmail send` |
+| Calendar | `gog calendar events`, `gog calendar create` |
+| Drive | `gog drive search` |
+| Contacts | `gog contacts list` |
+| Docs | `gog docs export`, `gog docs cat` |
+| Sheets | `gog sheets get`, `gog sheets update` |
+
+## Authentication
+```bash
+# 指定凭证
+gog auth credentials /path/to/credentials.json
+# 添加账号
+gog auth add ishenwei@gmail.com --services gmail,calendar,drive,contacts,docs,sheets
+# 查看授权
+gog auth list
+# 撤销授权
+gog auth revoke
+```
+
+## Configuration
+- 凭证路径：`/Users/weishen/Library/Application Support/gogcli/credentials.json`
+- 默认账号：`export GOG_ACCOUNT=ishenwei@gmail.com`
+
+## Related Concepts
+- [[OAuth]]：认证机制
+- [[Google-Cloud-Console]]：凭证创建
+- [[测试用户]]：绕过未验证应用限制
+- [[API-Enablement]]：Google API 启用
+- [[Gmail-API]]：Gmail 接口
+- [[Calendar-API]]：日历接口
+- [[Drive-API]]：云端硬盘接口
+
+## Related Entities
+- [[steipete-tap/gogcli]]：官方 Homebrew Tap
+- [[Google]]：服务提供方
+- [[Homebrew]]：安装工具
+
+## References
+- 官网：https://gogcli.sh
+- GitHub：https://github.com/steipete/gogcli