gws-shared

gws-shared 是 gws CLI（Google Workspace 命令行工具）的共享参考，汇总认证、全局标志与输出格式等通用模式。使用前需先用 google-connect 技能完成环境配置并运行 Google Connect 检查流程，由其处理缺失的命令行工具或安装恢复；配置后验证 gws --help，若仍不可用，应停止并报告 Google Workspace CLI 缺失。认证方式包括浏览器 OAuth（交互式）执行 gws auth login，以及服务账号方式设置环境变量 export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json。全局标志：--format 指定输出格式（json 默认、table、yaml、csv），--dry-run 仅在本地校验而不调用 API，--sanitize 通过 Model Armor 筛查响应。命令语法为 gws <service> <resource> [sub-resource] <method> [flags]。方法标志包括 --params 传 URL/查询参数、--json 传请求体、-o/--output 保存二进制响应到文件、--upload 以 multipart 上传文件内容、--page-all 自动分页（NDJSON 输出）、--page-limit 限制页数（默认 10）、--page-delay 设置页间延迟毫秒（默认 100）。安全规则要求：不得直接输出密钥或令牌，执行写入或删除命令前须与用户确认，破坏性操作优先用 --dry-run，可用 --sanitize 做 PII/内容安全筛查。Shell 提示：zsh 中 Sheet1!A1 这类范围的感叹号会触发历史扩展，应使用双引号包裹并转义内部引号，例如 --range "Sheet1!A1:D10"；含双引号的 JSON 应把 --params 和 --json 的值用单引号包裹，如 --params '{"pageSize": 5}'。社区反馈方面，鼓励为仓库点星，缺陷或功能请求请到仓库提交 issue，且提交前先检索已有 issue，若有匹配项则在原帖补充上下文而非重复创建。