SuperAPI AI 工具集

gws-events

办公与效率

查看项目

更新于 10-16 04:20

技能介绍

gws-events 是 gws-claude-plugin 中的一个技能,用于订阅 Google Workspace 事件。其命令形式为 gws events <resource> <method> [flags]。

用途 该技能面向 Google Workspace 事件订阅场景,允许用户通过命令行创建、管理订阅,并接收事件流。

前置条件 使用前需阅读 ../gws-shared/SKILL.md,了解认证方式、全局标志和安全规则。如果该文件缺失,需运行 gws generate-skills 生成。

辅助命令

  • +subscribe:订阅 Workspace 事件并以 NDJSON 流式输出。
  • +renew:续订或重新激活 Workspace Events 订阅。

API 资源与方法 message

  • stream:SendStreamingMessage 是一个流式调用,会返回任务更新事件流,直到任务进入中断或终止状态。

operations

  • get:获取长时间运行操作的最新状态。客户端可按 API 服务建议的间隔轮询操作结果。

subscriptions

  • create:创建 Google Workspace 订阅。
  • delete:删除 Google Workspace 订阅。
  • get:获取 Google Workspace 订阅的详细信息。
  • list:列出 Google Workspace 订阅。
  • patch:更新或续订 Google Workspace 订阅。
  • reactivate:重新激活已暂停的 Google Workspace 订阅。此方法会将订阅的 State 字段重置为 ACTIVE。使用前必须先修复导致订阅暂停的错误。此方法会忽略或拒绝当前不处于暂停状态的订阅。

tasks

  • cancel:从代理取消任务。如果支持,取消后不应再收到该任务的任务更新。
  • get:从代理获取任务的当前状态。
  • subscribe:TaskSubscription 是一个流式调用,会返回任务更新事件流。它将流附加到现有的进行中任务。如果任务已完成,流将返回已完成的任务(类似 GetTask)并关闭流。
  • pushNotificationConfigs:对 'pushNotificationConfigs' 资源的操作。

发现命令 在调用任何 API 方法之前,先检查它:

浏览资源和方法

gws events --help

检查方法的必需参数、类型和默认值

gws schema events.<resource>.<method> 使用 gws schema 的输出来构建 --params 和 --json 标志。

适用场景 适用于需要通过命令行管理 Google Workspace 事件订阅、接收事件流、管理任务及长时间运行操作的场景。

限制 资料未提供具体的认证细节、权限要求、配额限制、收费信息或平台支持范围,这些内容暂未提供。