SuperAPI AI 工具集

gws-events

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:gws-events 属于 googleworkspace/cli,用于订阅 Google Workspace 事件,可通过命令行管理订阅并流式接收事件。使用前需先阅读 ../gws-shared/SKILL.md 了解认证、全局标志与安全规则;若缺失则运行 gws generate-skills 生成。

主要能力:命令格式为 gws events <resource> <method> [flags]。辅助命令包括 +subscribe(订阅 Workspace 事件并以 NDJSON 流式输出)和 +renew(续期或重新激活订阅)。API 资源涵盖:message.stream 流式返回任务更新事件直至任务中断或终止;operations.get 获取长时间运行操作的最新状态;subscriptions 的 create、delete、get、list、patch、reactivate(将暂停订阅状态重置为 ACTIVE,需先修复导致暂停的错误,非暂停状态会被忽略或拒绝);tasks 的 cancel、get、subscribe,以及 pushNotificationConfigs 资源操作。

使用方式:调用 API 方法前先浏览资源与方法的帮助信息,例如 gws events --help;再用 gws schema events.<resource>.<method> 查看必填参数、类型和默认值,据此构建 --params 与 --json 标志。

适用场景:需要以命令行方式订阅、列出、更新或续期 Google Workspace 订阅,并流式消费事件或任务更新时使用。

限制:资料未提供具体价格、配额、平台支持范围及完整示例;实际参数与行为需以 gws schema 与共享技能文档为准。