name: gws-events
description: 订阅 Google Workspace 事件。
metadata:
    version: 0.22.5
    openclaw:
        category: "productivity"
        requires:
            bins:
                - gws
        cliHelp: "gws events --help"

events (v1)

先决条件： 阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则。若文件缺失，运行 gws generate-skills 创建。

gws events <资源> <方法> [标志]

辅助命令

API 资源

message

• stream — SendStreamingMessage 是一个流式调用，将返回任务更新事件的流，直到任务处于中断或终止状态。

operations

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

subscriptions

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

tasks

• cancel — 取消来自代理的任务。如果支持，预期不再收到该任务的更新。
• get — 获取来自代理的当前任务状态。
• subscribe — TaskSubscription 是一个流式调用，将返回任务更新事件的流。这将流附加到现有正在进行的任务。如果任务完成，流将返回已完成的任务（如同 GetTask）并关闭流。
• pushNotificationConfigs — 对 'pushNotificationConfigs' 资源的操作

发现命令

在调用任何 API 方法之前，先进行检查：

# 浏览资源和方法
gws events --help

# 检查方法的必需参数、类型和默认值
gws schema events.<资源>.<方法>

使用 gws schema 的输出来构建你的 --params 和 --json 标志。