核心功能
gws-chat 是 Google Workspace CLI (gws) 的 Chat 模块，提供对 Google Chat API 的完整命令行封装。支持空间生命周期管理（创建/删除/搜索/导入）、消息收发（含富媒体附件）、成员权限控制及自定义表情管理。
关键能力
- 空间管理：创建命名空间/群组聊天、搜索组织内空间、完成数据导入
- 消息系统：发送文本/富媒体消息、下载上传附件（
media资源） - 成员协作：
setup一键创建空间并批量添加成员 - 企业特性：管理员级空间搜索、自定义表情管理（需 Workspace 账户+管理员开启）
显著优点
- 官方背书：Google Workspace 原生 CLI，API 覆盖完整（Chat API v1）
- DevOps 友好：声明式参数（
--params/--json）、gws schema自检机制，便于 CI/CD 集成 - 迁移支持：
completeImport支持从 Slack/Mattermost 等企业聊天工具数据迁移 - 认证统一：继承
gws-shared的 OAuth 2.0 认证体系，支持用户凭据与服务账号
局限与风险
- 权限门槛高：自定义表情、管理员搜索等核心功能需 Workspace 管理员显式开启
- 功能渐进开放：群组聊天和 DM 需首条消息发送后才出现在
list结果中 - 数据不可逆：
delete操作级联删除所有子资源（消息、成员），无软删除恢复 - 依赖链条：需先安装
gws主 CLI 并配置gws-shared认证模块
适用场景
企业 IT 管理员、SRE 团队自动化协作空间管理；开发者构建 Chat 机器人与通知管道；组织执行合规审计与历史数据归档。
安全建议
- 严格遵循最小权限原则，避免为 CLI 配置全域管理员凭据
- 生产环境建议使用专用服务账号 + 密钥托管（如 GCP Secret Manager）
- 导入/删除操作前务必验证
--params参数，利用gws schema预检 API 契约