用途：通过命令行访问 Google Workspace 多项服务，并提供一批 + 前缀的快捷辅助命令，适合脚本化处理邮件、日程、文件与表格等日常事务。
主要能力：覆盖 Gmail（搜索、分流、发送、标签、过滤器、草稿）、日历、Drive、Sheets、Docs、Slides、Tasks、People、Chat、Meet、Forms、Keep、Admin，以及跨服务工作流。辅助命令如 gws gmail +triage 汇总未读、+send 发信、calendar +agenda 看日程、+insert 建事件、drive +upload 上传、sheets +read 与 +append 读写表格、docs +write 追加文本、chat +send 发消息、workflow +standup-report 等生成报告。
命令格式：gws <service> <resource> [sub-resource] <method> [flags]。通用标志包括 --params JSON（URL/查询参数）、--json JSON（请求体）、--upload PATH（上传媒体）、--output PATH（下载二进制）、--format json|table|yaml|csv（默认 json）、--page-all 与 --page-limit N（分页）、--dry-run（本地校验）。可用 gws schema <service>.<resource>.<method> 查看结构。
使用方式：需先完成 OAuth 设置，凭据位于 ~/.config/gws/credentials.json。每次 Gmail 原始调用需在 params 中带 "userId":"me"；日历时间用 RFC3339 带时区偏移。+insert 不添加会议链接，需用原始 events.insert 并设置 conferenceDataVersion=1 与 conferenceData.createRequest。分页 --page-all 输出 NDJSON。gmail.settings.basic 权限需手动 OAuth（本地 8085 端口的 Python 监听器），gws auth login --scopes 无法直接申请。
限制与注意事项：写入类操作（+send、+insert、+email-to-task、+file-announce、删除文件、删除事件、移入回收站）前应确认。人机阅读摘要用 --format table，脚本处理保持默认 json 以便管道给 jq。完整命令清单见 references/api_reference.md。具体收费、价格与授权细节资料未提供。