核心用法
gws-chat 是 Google Workspace Chat API 的命令行封装工具，提供完整的 Google Chat 管理能力。核心命令格式为 gws chat <resource> <method> [flags]，主要覆盖四大资源域：
Spaces（空间管理）：创建/删除/更新命名空间、查找私聊、搜索组织内空间、批量导入数据。支持级联删除（自动清理子资源）和 Import 模式迁移。
Messages（消息操作）：通过子资源 spaces.messages 实现消息 CRUD，配合 +send 快捷命令可快速发送消息到指定空间。
Members（成员管理）：空间成员增删改查，支持批量初始成员设置（setup 方法自动将调用者加入）。
Custom Emojis（自定义表情）：企业级表情管理，需管理员开启权限，支持创建、删除、查询组织级表情。
Media（媒体处理）：附件上传下载，支持 Google Chat 专用媒体端点。
所有 API 调用需前置配置 Google Workspace 认证（见 gws-shared/SKILL.md），支持应用认证和用户认证两种模式。
显著优点
1. 完整 API 覆盖：相比简易 webhook 工具，提供 Chat API v1 全能力，包括管理员级空间搜索（use_admin_access）、数据迁移等高级功能
2. 企业治理友好：支持组织架构级表情管理、空间审计、批量导入历史数据
3. 命令自发现：gws schema 机制可动态查询参数类型和约束，降低 API 学习成本
4. 集成 Google 生态：原生对接 Workspace 身份体系，权限模型与 Admin Console 一致
潜在局限
- 权限依赖重：大量功能（自定义表情、管理员搜索、数据导入）需特定 Admin 权限或组织级配置
- Group Chat 冷启动：API 限制下，群组和私聊需发送首条消息后才会出现在
list结果 - 无实时推送：纯请求-响应模式，无 WebSocket/Streaming 支持，需轮询
spaceEvents - Workspace 账户限制：个人 Google 账户无法使用自定义表情等企业功能
适合人群
- Workspace 管理员：批量管理组织聊天空间、审计成员关系、迁移历史数据
- DevOps/平台团队：构建 Chat 机器人、自动化工作流通知、集成 CI/CD 消息通道
- 企业应用开发者：开发深度集成的 Chat 应用，需细粒度 API 控制
常规风险
- 级联删除不可逆：
spaces.delete会永久清除所有消息和成员关系，无回收站机制 - 管理员权限滥用：
use_admin_access模式可遍历全组织空间，需严格审计调用身份 - 数据驻留合规：Chat 数据受 Google Workspace 数据区域策略约束，跨境场景需确认合规配置