文章目录一个命令行搞定 Google 全家桶这个工具 28k Star一个命令行搞定 Google 全家桶这个工具 28k StarGoogle Workspace 有一堆产品Drive、Gmail、Calendar、Sheets、Docs、Chat每个都有自己的 API每个 API 的调用方式还不一样。开发者想在命令行里操作这些服务要么写一堆 curl要么装一堆官方 SDK。gws 是 Google Workspace 团队开源的一个命令行工具把所有 Workspace 服务统一到一个 CLI 里。它在 GitHub 上拿到了 28,872 个 Star。这个工具最大的特点是不维护静态命令列表。它在运行时从 Google 的 Discovery Service 读取 API 定义动态生成所有命令。Google 新增一个 API 端点gws 自动就能用不需要等工具更新版本。安装方式有几种。最简单的是从 GitHub Releases 下载对应系统的预编译二进制文件。也可以用 npmnpm install -g googleworkspace/cli或者用 Homebrewbrew install googleworkspace-climacOS、Linux、Windows 都支持还有 Nix flake 可以直接跑。装好之后先做认证gws auth setup gws auth loginauth setup会帮你创建 GCP 项目、开启 API、配置 OAuth一条龙搞定。之后auth login选一下权限范围就能用了。认证方式有好几种。本地开发用交互式登录最方便。CI 环境可以先导出凭证文件然后设个环境变量就行gws auth export --unmasked credentials.json在目标机器上export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE/path/to/credentials.json也支持 Service Account 和直接传 Access Token适配各种场景。认证搞定之后操作 Google 服务就很直接了。列文件、建表格、发邮件都是一个命令的事gws drive files list --params {pageSize: 10} gws sheets spreadsheets create --json {properties: {title: Q1 Budget}} gws gmail send --to aliceexample.com --subject Hello --body Hi there每个命令都支持--help查看用法--dry-run预览请求但不实际执行。返回的结果全是结构化 JSON可以直接用 jq 管道处理。除了 Discovery 自动生成的命令gws 还提供了一批手工编写的 helper 命令用前缀标识。比如triage能快速看未读邮件摘要agenda显示今天的日程安排standup-report生成站会报告。这些命令会自动读取你 Google 账号的时区设置不需要手动指定。对于 AI Agent 场景gws 也很适配。项目自带 100 多个 Agent Skills 文件覆盖 Drive、Gmail、Docs、Calendar、Sheets 等所有服务还有 50 个现成的工作流配方。每个 API 响应都是结构化 JSONLLM 可以直接解析不需要额外写解析逻辑。Gemini CLI 用户还可以直接装扩展gemini extensions install https://github.com/googleworkspace/cli装完之后 Gemini CLI 就能直接调用所有 gws 命令认证信息自动继承不用重复登录。Sheets 操作有个小坑范围参数里的!在 bash 里会被当成历史展开所以必须用单引号包起来gws sheets spreadsheets values get \ --params {spreadsheetId: ID, range: Sheet1!A1:C10}gws 的退出码也是结构化的脚本里可以根据不同的错误码做分支处理。0 是成功1 是 API 错误2 是认证问题3 是参数校验失败。所有凭证在本地用 AES-256-GCM 加密存储密钥放在系统钥匙串里。如果是在服务器上跑也可以切换到文件存储模式。这个项目还在积极开发中API 可能会有变动。但对于需要在命令行或脚本里操作 Google Workspace 的开发者来说gws 比直接调 REST API 或者装一堆 SDK 要省事很多。I 可能会有变动。但对于需要在命令行或脚本里操作 Google Workspace 的开发者来说gws 比直接调 REST API 或者装一堆 SDK 要省事很多。