Gemini API 引入事件驱动 Webhooks，告别长时间任务轮询
2026/05/04 23:30阅读量 2
Google 于 2026 年 5 月 4 日在 Gemini API 中推出事件驱动 Webhooks，支持任务完成时实时推送 HTTP POST 通知，替代传统轮询方式。该功能遵循 Standard Webhooks 规范，通过签名确保安全，并支持全局和按请求的配置。
事件概述
2026 年 5 月 4 日，Google 宣布在 Gemini API 中引入事件驱动 Webhooks，旨在减少长时间运行任务（如深度研究、长视频生成、批量 API 处理等）的延迟和摩擦。此前开发者需通过连续轮询检查任务状态，现在 Gemini API 可在任务完成时主动推送实时 HTTP POST 请求到开发者服务器。
核心信息
- 安全与可靠性：实现严格遵循 Standard Webhooks 规范，每个请求使用
webhook-signature、webhook-id和webhook-timestamp头进行签名，确保幂等性并防止重放攻击。同时保证“至少一次”交付，并在 24 小时内自动重试失败通知。 - 配置方式：Webhooks 可在项目级别全局配置（通过 HMAC 保护），也支持在每次请求中动态覆盖，以将特定作业路由至不同端点（通过 JWKS 保护）。
- 快速上手：功能现已对所有 Gemini API 开发者开放。提供官方文档（含完整事件目录和端点安全指南）以及 Cookbook（端到端集成示例）。
值得关注
此功能使开发者能够更高效地构建复杂、长时间运行的 Agent 应用，无需浪费资源进行轮询，显著降低延迟和开发复杂度。