谷歌为 Gemini API 推出事件驱动 Webhook 推送机制
谷歌近日为 Gemini API 引入了事件驱动的 Webhook 推送功能，彻底改变了长时任务的通知方式。此前，当开发者使用 Deep Research、长视频生成或 Batch API 等耗时数分钟乃至数小时的任务时，只能通过反复轮询接口来查询任务进度，不仅增加系统负载，也影响了开发效率。
核心特性
据 Google 官方博客介绍，新功能在任务完成的那一刻，API 会立即向开发者的服务器发送实时 HTTP POST 负载，实现真正的即时通知。该实现遵循 Standard Webhooks 规范，每条请求均附带签名、唯一 ID 和时间戳，可有效防止重放攻击。
在可靠性方面，Webhook 采用至少一次送达（at-least-once）机制，若推送失败，系统会自动重试，最长持续 24 小时。开发者可在项目级别通过 HMAC 进行全局配置，也可以在单次请求中通过 JWKS 动态指定不同的回调地址，将特定任务路由到不同的处理端点。
开发体验升级
这一设计特别适合无服务器（serverless）架构场景。开发者只需「丢出任务、忘记它」，结果完成时 Gemini 自会主动通知，大大简化了异步任务处理流程。
适用场景
- Deep Research：复杂研究任务完成后即时推送
- 长视频生成：耗时长的媒体处理任务监控
- Batch API：批量处理数千条 prompt 时的进度追踪
目前该功能已面向所有 Gemini API 开发者开放，开发者可通过 Python SDK 快速配置 Webhook。