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 <资源> <方法> [标志]

辅助命令

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，并且任何特定于事件类型的属性将被删除。

• insert — 创建事件。
• instances — 返回指定重复事件的实例。
• list — 返回指定日历上的事件。
• move — 将事件移动到另一个日历，即更改事件的 organizer。请注意，只能移动默认事件；生日、focusTime、fromGmail、outOfOffice 和 workingLocation 事件无法移动。
• patch — 更新事件。此方法支持部分更新语义。
• quickAdd — 基于简单文本字符串创建事件。
• update — 更新事件。
• watch — 监视 Events 资源的变更。

freebusy

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

settings

• get — 返回单个用户设置。
• list — 返回认证用户的所有用户设置。
• watch — 监视 Settings 资源的变更。

发现命令

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

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

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

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