Google Workspace CLI：终极 gws 命令行工具

Google 为 Workspace 高级用户和 AI 开发者推出了一款变革性工具：gws - 一个无需样板代码即可解锁所有 Google Workspace API 的单一 CLI。从 Drive 文件到 Gmail 自动化，从 Calendar 事件到 Sheets 操作，这个由 Rust 驱动的强大工具一应俱全。

🚀 为什么 gws 改变一切

与传统静态命令列表的 API 客户端不同，gws 在运行时读取 Google 的 Discovery Service，并动态构建其完整的命令界面。当 Google 添加新 API 端点时，gws 会自动获取它们。不再需要翻阅 REST 文档或编写 curl 噩梦。

主要特性： - Drive、Gmail、Calendar、Sheets、Chat、Admin - 所有 Workspace API - 结构化 JSON 输出，完美适用于 AI 代理和脚本编写 - 40+ 内置代理技能，用于常见工作流 - 自动分页、dry-run、模式自省 - 跨平台二进制文件 通过 npm（无需 Rust 工具链）

🎯 快速开始（2 分钟）

# 全局安装
npm install -g @googleworkspace/cli

# 设置认证
gws auth setup

gws auth login

# 列出最近的 Drive 文件
gws drive files list --params '{"pageSize": 10}'

# 创建电子表格
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'

🤖 为 AI 代理打造

gws 附带 100+ 代理技能（SKILL.md 文件），覆盖所有 API 以及 Gmail 配方、Drive 自动化等。将它与您的 LLM 结合，实现自主 Workspace 管理：

# 安装所有技能
npx skills add https://github.com/googleworkspace/cli

# Gemini CLI 扩展
gemini extensions install https://github.com/googleworkspace/cli

🔐 多重认证工作流

• 交互式：gws auth login（加密凭据）
• 无头/CI：从交互会话导出凭据
• 服务账户：指向 JSON 密钥文件
• gcloud：GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)

💎 专业提示

# 以 NDJSON 流式传输所有文件
gws drive files list --page-all | jq -r '.files[].name'

# Dry-run Chat 消息
gws chat spaces messages create --dry-run

# 自省任何方法模式
gws schema drive.files.list

# Model Armor 集成用于安全代理
gws gmail users messages get --sanitize "projects/P/locations/L/templates/T"

📦 安装选项

# npm（推荐 - 包含二进制文件）
npm install -g @googleworkspace/cli

# Cargo
cargo install --git https://github.com/googleworkspace/cli --locked

# Nix
nix run github:googleworkspace/cli

⚠️ 重要说明

• 积极开发中 - 预计在 v1.0 前会有破坏性变更
• 非 Google 官方支持（但来自 googleworkspace 组织）
• 17.9k 星标，32 名贡献者，Apache-2.0 许可

gws 不仅仅是一个 CLI - 它是人类和 AI 代理 Google Workspace 自动化的未来。 今天就安装它，永远告别 API 文档搜寻。

⭐ GitHub 星标 | 📦 npm