SuperAPI AI 工具集

gws-events

通用与其它

查看项目

更新于 10-16 11:22

技能介绍

用途:gws-events 属于 gws 命令行工具,用于订阅 Google Workspace 事件,管理订阅生命周期并获取任务与操作状态。

前提:需先阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则;若该文件缺失,运行 gws generate-skills 生成。

主要能力:基础调用形式为 gws events <resource> <method> [flags]。辅助命令包括 +subscribe(订阅 Workspace 事件并以 NDJSON 流式输出)和 +renew(续订或重新激活订阅)。API 资源涵盖 subscriptions(create、delete、get、list、patch、reactivate)、operations(get,用于轮询长时间运行操作的最新状态)、tasks(cancel、get、subscribe,subscribe 为流式调用,持续返回任务更新事件直至任务完成或终止)以及 message(stream,返回任务更新事件流直到任务进入中断或终止状态)和 pushNotificationConfigs。

用法:调用任何 API 方法前应先查看,使用 gws events --help 浏览资源与方法,使用 gws schema events.<resource>.<method> 查看必需参数、类型与默认值,再据此构造 --params 与 --json 标志。

限制:资料未提供认证细节、权限范围、配额、计费及具体可用性信息,这些需参考 gws-shared 文档。reactivate 要求先修复导致订阅被暂停的错误,否则会被忽略或拒绝;cancel 之后可能不再收到该任务的更新。