Google Workspace CLI：Google gws 一站式打开终端办公新篇章

近年来，自动化办公逐渐成为开发者和现代团队的必需品，而Google最近发布的开源工具——Google Workspace CLI（gws），无疑是一个重磅消息。一经发布，它便凭借强大的功能狂揽超过10K+ GitHub Star，成为开发者圈子中的焦点。

什么是 Google Workspace CLI（gws）？

Google Workspace CLI（gws）是Google团队发布的一款命令行工具，它支持对Google Workspace生态的全面管理，包括Gmail、Drive、Calendar、Sheets、Docs等多个服务。

通过动态构建的特性，gws可以根据Google的Discovery Service实时读取API信息并构建命令界面，确保新功能或端点发布后用户无需手动更新工具，便可直接使用。

gws 的核心亮点

gws的强大体现在多个方面，下列几个特性让开发者感到赞叹：

1. 一站式操作 Workspace 生态

• 支持几乎所有Google Workspace服务（驱动、邮件、日历等）。
• 将API功能完整映射到命令行操作，减少复杂的代码集成。

2. 同时面向人类与 AI 代理

• 为人类设计：gws提供清晰的帮助文档（--help）、预览执行（--dry-run）和自动分页功能。
• 为AI代理设计：支持结构化JSON输出，可与AI模型进行无缝交互，同时内置100多个Agent Skills支持自动化。

3. 灵活的认证机制

gws支持多种认证方式，包括交互式认证、服务账号、访问令牌等。配合AES-256加密存储机制，即便是CI环境也能流畅使用。

4. Model Armor 安全保护

借助Google Cloud的Model Armor功能，gws可在响应到达前扫描潜在的安全风险（例如提示注入），通过--sanitize选项可直接启用。

5. MCP 协议扩展能力

支持MCP（My Command Protocol）服务器协议，通过标准输入输出接口，能将Google API暴露给诸如Claude Desktop或Gemini CLI等终端客户端。

快速上手：安装与配置

尽管功能强大，gws的安装过程却非常简单。以下是具体步骤：

1. 准备条件

• 确保安装了Node.js 18+。
• 拥有一个Google Cloud项目，供生成OAuth凭据。
• 至少一个Google账号和Google Workspace权限。

2. 安装方法

• 推荐使用npm安装：

  npm install -g @googleworkspace/cli

• 也可以从GitHub上下载对应操作系统的二进制文件。
• 通过Rust工具链可以直接从源码构建。

3. 配置与认证

完成安装后，按以下步骤进行OAuth配置：

gws auth setup     # 设置Google Cloud凭据
gws auth login     # OAuth登录

如遇问题，例如「访问被阻止」，请确保将账号添加为OAuth测试用户。

强大的实用场景示例

以下是一些实用的gws命令示例：

• 列出最近10个文件：

  gws drive files list --params '{"pageSize": 10}'

• 创建电子表格：

  gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'

• 通过Chat发送消息：

  gws chat spaces messages create --params '{"parent": "spaces/xyz"}' \ --json '{"text": "Deploy complete."}'

可能遇到的问题与解决方法

在使用gws时，可能会遇到以下问题：

• 问题1：「访问被阻止」错误。请检查OAuth账号是否包含在测试用户中。
• 问题2：提示「Google未验证此应用」，点击高级选项继续。
• 问题3：出现「Redirect URI Mismatch」错误，请确保OAuth客户端类型设置为Desktop App。

结语

gws的诞生为Google Workspace的用户带来了极大的便利，它既为开发者提供了一站式的命令行操作，又为AI自动化提供了独特的接口支持。如果你正在寻找一种高效管理Workspace生态的方法，不妨尝试一下gws。

想了解更多信息或安装使用，请访问gws的开源项目页面：GitHub gws。