65 lines
1.7 KiB
Markdown
65 lines
1.7 KiB
Markdown
---
|
||
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
|