用途:gws-chat 是 Google Workspace CLI 的 Google Chat 子命令,用于管理 Chat 空间与消息。
主要能力:通过 gws chat <resource> <method> [flags] 调用 Chat v1 API。资源包括 customEmojis(创建、删除、获取、列出)、media(下载、上传附件)、spaces(创建、删除、获取、列出、更新、搜索、setup、findDirectMessage、completeImport)、members、messages、spaceEvents、users、sections。快捷命令 +send 可向空间发送消息。
使用方式:先阅读 ../gws-shared/SKILL.md 了解认证、全局标志与安全规则;若缺失,运行 gws generate-skills 生成。用 gws chat --help 浏览资源与方法,用 gws schema chat.<resource>.<method> 查看必填参数、类型与默认值,再据此构造 --params 与 --json 标志。
适用场景:在 Google Workspace 环境中自动化 Chat 空间管理、消息发送、成员与表情维护、附件上传下载等。
限制:自定义表情仅对 Google Workspace 账号可用,且需管理员为组织开启;删除空间为级联删除,会一并删除消息与成员关系;群聊和私信在发送首条消息前不会出现在列表中;findDirectMessage 未找到时返回 404 NOT_FOUND;更新 displayName 遇 ALREADY_EXISTS 需换名;search 需设置 use_admin_access 为 true。其余细节暂未提供。