用途
gws-events-renew 属于 Google Workspace 命令行工具(googleworkspacecli)中的事件订阅相关技能,其作用是续期(Renew)或重新激活(reactivate)Google Workspace Events 订阅。
主要能力
- 重新激活指定的单个订阅:通过 --name 参数传入订阅名称(例如 subscriptions/SUB_ID)。
- 批量续期:通过 --all 参数续期所有在 --within 时间窗口内即将过期的订阅。
- --within 用于设定 --all 的时间窗口,默认值为 1h,可写作 1h、30m、2d 等形式。
使用方式
前提:需先阅读 ../gws-shared/SKILL.md,以了解认证方式、全局参数和安全规则。如果该文件缺失,运行 gws generate-skills 生成。
命令:
gws events +renew
参数说明:
- --name:非必填,无默认值,指定要重新激活的订阅名称(如 subscriptions/SUB_ID)。
- --all:非必填,无默认值,续期所有在 --within 窗口内即将过期的订阅。
- --within:非必填,默认 1h,用于 --all 的时间窗口(如 1h、30m、2d)。
示例:
gws events +renew --name subscriptions/SUB_ID gws events +renew --all --within 2d
适用场景
适用于需要对 Google Workspace Events 订阅进行维护、防止订阅因未续期而过期的场景。可结合 cron 定时任务使用 --all,让订阅保持存活。
限制与注意事项
- 订阅若不定期续期将会过期。
- 使用前必须完成认证相关准备,详见 gws-shared 文档。
- 关于定价、平台支持范围等更多信息,资料暂未提供。
相关
- gws-shared — 全局参数与认证
- gws-events — 所有订阅 Google Workspace 事件的命令