name: gws-calendar
description: Google Calendar：管理日历和事件。
metadata:
    version: 0.22.5
    openclaw:
        category: "productivity"
        requires:
            bins:
                - gws
        cliHelp: "gws calendar --help"

calendar (v3)

前提条件： 请阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则。如果该文件不存在，请运行 gws generate-skills 创建它。

gws calendar <resource> <method> [flags]

辅助命令

API 资源

acl

• delete — 删除访问控制规则。
• get — 返回访问控制规则。
• insert — 创建访问控制规则。
• list — 返回日历的访问控制列表中的规则。
• patch — 更新访问控制规则。此方法支持补丁语义。
• update — 更新访问控制规则。
• watch — 监视 ACL 资源的更改。

calendarList

• delete — 从用户的日历列表中移除日历。
• get — 从用户的日历列表中返回一个日历。
• insert — 将现有日历插入用户的日历列表。
• list — 返回用户日历列表中的日历。
• patch — 更新用户日历列表中的现有日历。此方法支持补丁语义。
• update — 更新用户日历列表中的现有日历。
• watch — 监视 CalendarList 资源的更改。

calendars

• clear — 清空主日历。此操作会删除与账户主日历关联的所有事件。
• delete — 删除辅助日历。使用 calendars.clear 清空主日历上的所有事件。
• get — 返回日历的元数据。
• insert — 创建辅助日历。

请求中的经过身份验证的用户将成为新日历的数据所有者。

注意：我们建议以预期的日历数据所有者身份进行身份验证。您可以使用域范围的授权委托，使应用程序能够代表特定用户执行操作。不要使用服务帐号进行身份验证。如果使用服务帐号进行身份验证，该服务帐号将成为数据所有者，这可能导致意外行为。

• patch — 更新日历的元数据。此方法支持补丁语义。
• update — 更新日历的元数据。

channels

• stop — 停止通过此通道监视资源。

colors

• get — 返回日历和事件的颜色定义。

events

• delete — 删除事件。
• get — 根据 Google 日历 ID 返回事件。要使用事件的 iCalendar ID 检索事件，请调用 events.list 方法并使用 iCalUID 参数。
• import — 导入事件。此操作用于将现有事件的私有副本添加到日历。只有 eventType 为 default 的事件才能被导入。

已弃用的行为：如果导入了非 default 事件，其类型将更改为 default，并且任何特定于事件类型的属性都可能会被删除。

• insert — 创建事件。
• instances — 返回指定重复事件的实例。
• list — 返回指定日历上的事件。
• move — 将事件移动到另一个日历，即更改事件的组织者。注意：只有 default 事件可以移动；birthday、focusTime、fromGmail、outOfOffice 和 workingLocation 事件无法移动。
• patch — 更新事件。此方法支持补丁语义。
• quickAdd — 基于简单文本字符串创建事件。
• update — 更新事件。
• watch — 监视 Events 资源的更改。

freebusy

• query — 返回一组日历的空闲/忙碌信息。

settings

• get — 返回单个用户设置。
• list — 返回经过身份验证的用户的所有用户设置。
• watch — 监视 Settings 资源的更改。

发现命令

在调用任何 API 方法之前，请先检查它：

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

# 检查方法的必需参数、类型和默认值
gws schema calendar.<resource>.<method>

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