用途:gws-events 用于通过命令行订阅 Google Workspace 事件,并对相关订阅与任务进行管理。资料显示其调用形式为 gws events <resource> <method> [flags]。
主要能力:提供辅助命令 +subscribe(订阅 Workspace 事件并以 NDJSON 流式输出)与 +renew(续订或重新激活 Workspace Events 订阅)。API 资源包括:message 的 stream(流式调用,返回任务更新事件直到任务中断或终止);operations 的 get(获取长时操作最新状态,供轮询);subscriptions 的 create、delete、get、list、patch(更新或续订订阅)、reactivate(将挂起订阅重置为 ACTIVE,需先修复导致挂起的问题);tasks 的 cancel、get、subscribe(将流附加到进行中的任务,任务完成时返回已完成任务并关闭流);以及 pushNotificationConfigs 资源。
使用方式:前置条件为阅读 ../gws-shared/SKILL.md 获取鉴权、全局标志与安全规则;若缺失可运行 gws generate-skills 生成。调用前可先浏览资源与方法:gws events --help;再查看某方法的必填参数、类型与默认值:gws schema events.<resource>.<method>,据此构建 --params 与 --json。资料未提供具体参数取值与示例命令。
适用场景:需要以命令行方式订阅、续订或管理 Google Workspace 事件订阅,并流式消费任务更新事件的自动化与集成场景。
限制:具体鉴权配置、配额、计费、平台支持与完整错误处理细节暂未提供;reactivate 仅适用于当前处于挂起状态的订阅,其他状态会被忽略或拒绝。