用途
gws-events-renew 用于续期（renew）或重新激活（reactivate）Google Workspace Events 订阅。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
适用场景
- 需要保持单个 Workspace Events 订阅长期有效时，使用 --name 定向续期。
- 需要批量维护多个订阅时，使用 --all 配合 --within 续期即将过期的订阅。
- 可结合 cron 定时任务使用 --all，自动保持订阅存活。
限制与注意事项
- 订阅若不定期续期会过期。
- 使用前必须完成 gws-shared 中的认证与安全规则配置。
- 关于具体认证方式、全局参数细节，资料中未提供，需参考 gws-shared 文档。
相关命令
- gws-shared — 全局参数与认证
- gws-events — 所有订阅 Google Workspace 事件的命令