用途:通过 gws 命令行订阅 Google Workspace 事件,并将其以 NDJSON 形式流式输出,可写入终端或按事件拆分为独立 JSON 文件。
主要能力:支持指定目标资源 URI(--target,如 //chat.googleapis.com/spaces/SPACE_ID)和逗号分隔的 CloudEvents 类型(--event-types);可复用已有 Pub/Sub 订阅(--subscription)或由指定 GCP 项目(--project)创建相关资源;可控制每批拉取条数(--max-messages,默认 10)、拉取间隔秒数(--poll-interval,默认 5)、单次拉取即退出(--once)、退出时清理所创建的 Pub/Sub 资源(--cleanup)、不自动确认消息(--no-ack),以及将事件写入目录(--output-dir)。
使用方式:基本命令为 gws events +subscribe,可按需附加上述参数;示例包括指定 target、event-types 与 project 订阅,或用 --subscription 配合 --once 拉取一次。运行时按 Ctrl-C 可优雅停止。
限制与注意:使用前须阅读 ../gws-shared/SKILL.md 了解认证、全局标志与安全规则,若缺失可运行 gws generate-skills 生成。该命令属于写操作,执行前需与用户确认。不加 --cleanup 时 Pub/Sub 资源会保留以便重连。