核心功能
gws-chat 是 Google Workspace CLI (gws) 的 Google Chat 管理技能，提供对 Chat API v1 的完整封装。主要能力包括：
- 空间管理：创建、删除、更新、搜索聊天空间（spaces），支持导入模式与直接消息查找
- 消息与媒体：发送消息、上传/下载附件媒体文件
- 成员管理：通过
spaces.members子资源管理空间成员 - 自定义表情：创建、删除、查询组织级自定义表情（需管理员开启权限）
- 管理功能：管理员可搜索全组织空间、完成导入流程
显著优点
1. 企业级集成：原生对接 Google Workspace，支持应用身份验证与用户身份验证双模式
2. 批量操作能力：适合 IT 管理员批量管理企业聊天空间
3. 数据迁移支持：completeImport 与导入模式支持从其他平台迁移历史数据
4. CLI 自动化：可与脚本、CI/CD 流程集成，实现空间生命周期自动化管理
潜在局限
- 权限门槛高：大量功能（自定义表情、空间搜索、导入）要求管理员预先配置组织级权限
- Workspace 专属：普通 Gmail 账户无法使用，仅限付费 Workspace 订阅
- 功能依赖外部：消息发送等常用操作需调用子技能
gws-chat-send - 级联删除风险：
spaces.delete默认级联删除所有子资源，操作不可逆
适用人群
- Google Workspace 管理员与 IT 运维团队
- 需要自动化管理企业协作空间的技术人员
- 执行数据迁移项目的系统集成商
安全风险提示
- 权限扩散：
use_admin_access模式需谨慎使用，避免越权操作 - 数据丢失：删除空间操作不可撤销，建议先备份关键消息
- 认证依赖：需严格遵循
gws-shared安全规范，OAuth 凭据保护不当可能导致全组织数据泄露