用途:gws gmail +watch 用于监视 Gmail 新邮件,并将邮件以 NDJSON(每行一个 JSON)形式持续流式输出,适合需要实时消费邮件数据的脚本或管道场景。
前置条件:需先阅读 ../gws-shared/SKILL.md 了解认证、全局参数与安全规则;若该文件缺失,运行 gws generate-skills 生成。
用法:gws gmail +watch
主要参数:--project 指定 Pub/Sub 所用 GCP 项目 ID;--subscription 使用已有 Pub/Sub 订阅(跳过自动创建);--topic 使用已授予 Gmail 推送权限的已有主题;--label-ids 以逗号分隔 Gmail 标签 ID 进行过滤(如 INBOX,UNREAD);--max-messages 每次拉取最大消息数,默认 10;--poll-interval 拉取间隔秒数,默认 5;--msg-format 邮件格式,可选 full、metadata、minimal、raw,默认 full;--once 仅拉取一次后退出;--cleanup 退出时删除本次创建的 Pub/Sub 资源;--output-dir 将每条消息分别写入该目录下的独立 JSON 文件。
示例:gws gmail +watch --project my-gcp-project;gws gmail +watch --project my-project --label-ids INBOX --once;gws gmail +watch --subscription projects/p/subscriptions/my-sub;gws gmail +watch --project my-project --cleanup --output-dir ./emails。
限制与提示:Gmail watch 在 7 天后过期,需要重新运行以续期;不使用 --cleanup 时,Pub/Sub 资源会保留以便重连;按 Ctrl-C 可优雅停止。相关资料未提供计费、平台兼容性及更多错误处理细节。