其他
需要管理 Google Chat 空间、消息…
当需要通过命令行管理 Google Chat/Google Workspace 的 Chat spaces、messages、members、media 和 customEmojis 时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 40/100 ×0.15
适用场景
需要管理 Google Chat 空间、特定
解决思路
- 先阅读 `../gws-shared/SKILL.md`,获取认证、全局 flags 和安全规则;若该文件缺失,运行 `gws generate-skills` 生成它。
- 使用基础命令格式 `gws chat <resource> <method> [flags]` 调用 Google Chat API。
- 使用 helper 命令 `+send` 向一个 space 发送消息。
- 调用 `gws chat customEmojis create` 创建自定义 emoji;自定义 emoji 仅适用于 Google Workspace 账号,且管理员必须为组织开启自定义 emoji;更多信息见 [Learn about custom emojis in Google Chat](https://support.google.com/chat/answer/12800149) 和 [Manage custom emoji permissions](https://support.google.com/a/answer/12850085)。
- 调用 `gws chat customEmojis delete` 删除自定义 emoji;默认情况下用户只能删除自己创建的自定义 emoji,管理员分配的 [Emoji managers](https://support.google.com/a/answer/12850085) 可以删除组织内任意自定义 emoji;自定义 emoji 仅适用于 Google Workspace 账号,且管理员必须为组织开启自定义 emoji;更多信息见 [Learn about custom emojis in Google Chat](https://support.google.com/chat/answer/12800149)。
- 调用 `gws chat customEmojis get` 返回自定义 emoji 的详情;自定义 emoji 仅适用于 Google Workspace 账号,且管理员必须为组织开启自定义 emoji;更多信息见 [Learn about custom emojis in Google Chat](https://support.google.com/chat/answer/12800149) 和 [Manage custom emoji permissions](https://support.google.com/a/answer/12850085)。
- 调用 `gws chat customEmojis list` 列出已认证用户可见的自定义 emoji;自定义 emoji 仅适用于 Google Workspace 账号,且管理员必须为组织开启自定义 emoji;更多信息见 [Learn about custom emojis in Google Chat](https://support.google.com/chat/answer/12800149) 和 [Manage custom emoji permissions](https://support.google.com/a/answer/12850085)。
- 调用 `gws chat media download` 下载媒体;下载支持的 URI 为 `/v1/media/{+name}?alt=media`。
- 调用 `gws chat media upload` 上传附件;示例见 [Upload media as a file attachment](https://developers.google.com/workspace/chat/upload-media-attachments)。
- 调用 `gws chat spaces completeImport` 完成指定 space 的 [导入流程](https://developers.google.com/workspace/chat/import-data),并使其对用户可见。
- 调用 `gws chat spaces create` 创建 space;可用于创建命名 space,或在 `Import mode` 创建 group chat;示例见 [Create a space](https://developers.google.com/workspace/chat/create-spaces)。
- 调用 `gws chat spaces delete` 删除命名 space;始终执行级联删除,这意味着 space 的子资源(如 space 中发布的消息和 space 中的成员关系)也会被删除;示例见 [Delete a space](https://developers.google.com/workspace/chat/delete-spaces)。
- 调用 `gws chat spaces findDirectMessage` 返回与指定用户的现有 direct message;若未找到 direct message space,返回 `404 NOT_FOUND`;示例见 [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message);使用 [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) 时,返回指定用户与调用 Chat app 之间的 direct message space。
- 调用 `gws chat spaces get` 返回 space 详情;示例见 [Get details about a space](https://developers.google.com/workspace/chat/get-spaces)。
- 调用 `gws chat spaces list` 列出调用者所属的 spaces;group chats 和 DMs 在发送第一条消息前不会被列出;示例见 [List spaces](https://developers.google.com/workspace/chat/list-spaces)。
- 调用 `gws chat spaces patch` 更新 space;示例见 [Update a space](https://developers.google.com/workspace/chat/update-spaces);若更新 `displayName` 字段并收到 `ALREADY_EXISTS` 错误,尝试不同的 display name,因为 Google Workspace 组织内现有 space 可能已使用该 display name。
- 调用 `gws chat spaces search` 根据管理员搜索返回 Google Workspace 组织中的 spaces 列表;在请求中设置 `use_admin_access` 为 `true`;示例见 [Search for and manage spaces](https://developers.google.com/workspace/chat/search-manage-admin)。
- 调用 `gws chat spaces setup` 创建 space 并添加指定用户;调用用户会自动加入,不应在请求中作为 membership 指定;示例见 [Set up a space with initial members](https://developers.google.com/workspace/chat/set-up-spaces);要指定要添加的人类成员,使用适当的 `membership.member.name` 添加 memberships;要添加人类用户,使用 `users/{user}`,其中 `{user}` 可以是用户的 email address。
- 通过 `gws chat spaces members <method> [flags]` 对 'members' 资源执行操作。
- 通过 `gws chat spaces messages <method> [flags]` 对 'messages' 资源执行操作。
- 通过 `gws chat spaces spaceEvents <method> [flags]` 对 'spaceEvents' 资源执行操作。
- 通过 `gws chat users sections <method> [flags]` 对 'sections' 资源执行操作。
- 通过 `gws chat users spaces <method> [flags]` 对 'spaces' 资源执行操作。
- 在调用任何 API 方法之前,先检查它:运行 `gws chat --help` 浏览资源和 methods。
- 运行 `gws schema chat.<resource>.<method>` 检查方法的必填参数、类型和默认值。
- 使用 `gws schema` 输出构建 `--params` 和 `--json` flags。
适用边界 · 注意事项
- 未安装 `gws`,或未按 `../gws-shared/SKILL.md` 完成认证、全局 flags 和安全规则配置时,不要使用。
- 非 Google Workspace 账号,或管理员未为组织开启自定义 emoji 时,`customEmojis` 相关方法不可用。
- 没有管理员权限或未在 `spaces search` 请求中设置 `use_admin_access=true` 时,不能用管理员搜索方式列出组织中的 spaces。