gws-events-subscribeGoogle官方放心用让 AI 帮你订阅 Google Workspace 事件,并以 NDJSON 实时拉取到本地。
这个 Skill 封装了 `gws events +subscribe` 命令,用于为指定的 Google Workspace 资源(如 Chat 空间)创建事件订阅,并通过 GCP Pub/Sub 轮询消息、以 NDJSON 格式流式输出。你可以用 `--target` 指定资源 URI、`--event-types` 过滤 CloudEvents 类型,也可以直接用 `--subscription` 复用已有的 Pub/Sub 订阅;支持设置每次拉取条数、轮询间隔、一次性拉取(`--once`),以及把每条事件单独写成 JSON 文件(`--output-dir`)。默认会自动确认消息,加 `--no-ack` 则保留待确认。
适合需要实时监控 Chat 消息、成员变更或其他 Workspace 事件的场景,也常用于事件审计、备份和自动化流水线。前提是已安装 `gws` CLI 并完成 `gws-shared` 里的认证,且有可用的 GCP 项目、Pub/Sub 权限。注意这是写操作,执行前会向你确认;不加 `--cleanup` 时 Pub/Sub 资源会保留以便重连,按 Ctrl-C 可优雅退出。
在下面找到你用的工具,复制命令粘进终端就装好了:
npx skills add googleworkspace/cli 装好后不用任何配置,直接在对话里说:
帮我订阅这个 Chat 空间的新消息,每 5 秒拉一次并保存到 events 文件夹。 AI 检测到任务匹配时会自动加载这个 Skill,不需要手动开关。
SKILL.md 需要已安装 `gws` CLI 并完成 `gws-shared` 中的认证;还要有 GCP 项目、Pub/Sub API 已启用,并对目标 Workspace 资源具备读取权限。
加 `--cleanup` 会在停止监听时自动删除本次创建的 Pub/Sub 资源,适合一次性测试;不加则会保留,方便下次重新连接或长期监听。
只要是 Google Workspace Events API 支持的 CloudEvents 类型即可,例如 Chat 消息创建、成员变更等,用 `--event-types` 指定,多个类型用逗号分隔。