返回全部 Skills

gws-events-subscribe

数据处理 官方认证

Google Workspace Events:订阅 Workspace 事件并以 NDJSON 格式进行流式传输。

12.3k

下载量

AI SkillHub 能力展示图

安装方式

命令行安装

在项目根目录执行以下命令,完成 Skill 安装。

npx bzskills add googleworkspace/cli --skill gws-events-subscribe

skill.md

name: gws-events-subscribe
description: Google Workspace Events:订阅 Workspace 事件并以 NDJSON 格式进行流式传输。
metadata:
    version: 0.22.5
    openclaw:
        category: "productivity"
        requires:
            bins:
                - gws
        cliHelp: "gws events +subscribe --help"

events +subscribe

前提条件: 阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则。如果该文件缺失,请运行 gws generate-skills 创建。

订阅 Workspace 事件并以 NDJSON 格式流式输出

用法

gws events +subscribe

标志

标志必需默认值描述
--targetWorkspace 资源 URI(例如 //chat.googleapis.com/spaces/SPACE_ID)
--event-types要订阅的逗号分隔的 CloudEvents 类型
--project用于 Pub/Sub 资源的 GCP 项目 ID
--subscription现有的 Pub/Sub 订阅名称(跳过设置)
--max-messages10每次拉取批次的最大消息数(默认:10)
--poll-interval5拉取间隔秒数(默认: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
gws events +subscribe --subscription projects/p/subscriptions/my-sub --once
gws events +subscribe ... --cleanup --output-dir ./events

提示

  • 如果不使用 --cleanup,Pub/Sub 资源将保留以便重新连接。
  • 按 Ctrl-C 可优雅停止。
[!CAUTION]
这是一个 写入 命令 — 执行前请先获得用户确认。

另请参阅