SuperAPI AI 工具集

gws-events-subscribe

办公与效率

查看项目

更新于 10-15 21:10

技能介绍

用途:订阅 Google Workspace 事件,并以 NDJSON 形式流式输出,便于后续处理或落盘。

主要能力:通过 gws events +subscribe 发起订阅,可指定 Workspace 资源 URI、CloudEvents 事件类型、GCP 项目及 Pub/Sub 订阅,并控制拉取行为。

必要用法:命令为 gws events +subscribe。前置条件:先阅读 ../gws-shared/SKILL.md 获取认证、全局标志和安全规则,缺失时运行 gws generate-skills 创建。常用参数:--target 指定 Workspace 资源 URI(如 //chat.googleapis.com/spaces/SPACE_ID);--event-types 为逗号分隔的 CloudEvents 类型;--project 指定 Pub/Sub 资源所在 GCP 项目;--subscription 使用已有 Pub/Sub 订阅名以跳过初始化;--max-messages 每批拉取上限(默认 10);--poll-interval 拉取间隔秒数(默认 5);--once 单次拉取后退出;--cleanup 退出时删除创建的 Pub/Sub 资源;--no-ack 不自动确认消息;--output-dir 将每个事件写入该目录下独立 JSON 文件。示例:gws events +subscribe --target '//chat.googleapis.com/spaces/SPACE' --event-types 'google.workspace.chat.message.v1.created' --project my-project;也可用 --subscription 复用订阅并配合 --once,或加 --cleanup --output-dir ./events。提示:不使用 --cleanup 时 Pub/Sub 资源会保留以便重连;按 Ctrl-C 可优雅停止。

限制与注意:该命令属于写操作,执行前需与用户确认;认证、全局标志与安全规则依赖 gws-shared 文档,价格、配额、支持的事件类型全集等资料暂未提供。