核心用法
gws 是 Google Workspace 官方推出的统一命令行工具，采用标准化语法 gws <service> <resource> [sub-resource] <method> 覆盖 Sheets、Drive、Gmail 等全部 Workspace 服务。认证层支持浏览器交互式 OAuth 与服务账号密钥两种模式，通过 GOOGLE_APPLICATION_CREDENTIALS 环境变量即可切换无人值守场景。
全局设计体现 Google API 工程规范：--format 统一输出为 JSON/Table/YAML/CSV，--dry-run 实现本地预校验避免误操作，--sanitize 集成 Model Armor 对响应内容进行 PII 与有害信息过滤。分页查询通过 --page-all 自动聚合，配合 --page-limit 与 --page-delay 实现速率管控，返回 NDJSON 流式格式便于下游管道处理。
显著优点
- 统一入口：终结了各服务分散的
gsutil、gam等工具碎片化问题 - 安全内置：
--sanitize直接对接 Google 原生内容安全模型，企业合规友好 - 管道友好：JSON/NDJSON 原生支持，与
jq、xargs等 Unix 工具链无缝衔接 - 分页自动化：告别手动处理
nextPageToken的样板代码
潜在局限
- 生态成熟度：当前 v0.22.2 处于早期阶段，部分高级 API 特性可能滞后于官方 REST 文档
- zsh 兼容性：
!符号与历史扩展冲突，需强制使用双引号转义，增加脚本编写心智负担 - 冷启动延迟：OAuth 浏览器流程与 service account 文件读取在 CI/CD 场景需额外配置缓存
适合人群
Workspace 管理员、需要批量处理 Sheets/ Drive 数据的数据工程师、以及构建 Google API 自动化管道的 DevOps 团队。对现依赖 gcloud 混搭多种脚本的用户尤为合适。
常规风险
- 凭证泄露：
GOOGLE_APPLICATION_CREDENTIALS指向的 JSON 密钥文件需严格限制文件权限（建议 0600），避免提交至版本控制 - 误删风险：写操作虽建议
--dry-run预演，但工具本身不强制交互确认，脚本化执行时需谨慎 - API 配额：大规模分页查询可能触发 QPS 限制，需合理设置
--page-delay