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