SuperAPI AI 工具集

gws-events-renew

办公与效率

查看项目

更新于 10-16 09:37

技能介绍

用途

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 事件的命令