用途:订阅 Google Workspace 事件,并将事件流以 NDJSON 形式输出。命令形式为 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 项目 ID;--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 projects/p/subscriptions/my-sub --once 直接基于已有订阅拉取一次,或配合 --cleanup --output-dir ./events 使用。
注意事项:未使用 --cleanup 时,Pub/Sub 资源会保留以便重连;按 Ctrl-C 可优雅停止;该命令属于写操作,执行前需与用户确认。参见 gws-shared(全局标志与认证)和 gws-events(全部订阅 Google Workspace 事件的命令)。
限制:资料未提供认证细节、支持的完整事件类型列表、错误处理或配额信息。