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 检索事件，请使用 iCalUID 参数调用 events.list 方法。
• import — 导入一个事件。此操作用于将现有事件的私有副本添加到日历。只有 eventType 为 default 的事件才能被导入。
  已弃用的行为：如果导入了非默认事件，其类型将更改为 default，并且其可能具有的任何事件类型特定属性都将被丢弃。
• insert — 创建一个事件。
• instances — 返回指定重复事件的实例。
• list — 返回指定日历上的事件。
• move — 将事件移动到另一个日历，即更改事件的组织者。请注意，只有默认事件可以移动；生日、专注时间、来自 Gmail、外出办公和工作地点事件无法移动。
• 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 标志。