用途:通过 gws 命令行工具操作 Google Workspace 各项服务,适合在终端或自动化流程中完成文件、邮件、表格、文档、会议等任务。
主要能力:覆盖 Drive、Sheets、Gmail、Docs、Slides、People、Chat、Meet、Forms、Admin Reports、Events、Keep、Classroom、Model Armor 及跨服务 Workflow;提供 +upload、+read、+append、+send、+triage、+reply、+write、+subscribe 等快捷命令,以及角色化场景(如行政助理、项目经理、销售运营)和多步配方(如整理 Drive 文件夹、创建费用表、发送团队公告)。
使用方式:需将 gws 二进制放入 $PATH,版本 0.16.0+。认证可用 gws auth login(浏览器 OAuth)或设置 GOOGLE_APPLICATION_CREDENTIALS 指向服务账号密钥,用 gws auth status 检查状态。命令语法为 gws <service> <resource> [sub-resource] <method> [flags],支持 --format、--dry-run、--sanitize、--params、--json、--output、--upload、--page-all 等全局参数,可用 gws <service> --help 和 gws schema 探索命令。
限制与安全:执行写入或删除前需与用户确认,破坏性操作优先使用 --dry-run,可用 --sanitize 做内容安全筛查,禁止直接输出密钥或令牌。退出码 0 成功、1 API 错误、2 认证错误、3 校验错误、4 发现错误、5 内部错误。具体各服务资源与方法细节需查阅对应参考文件。