# 通过 Gemini API 中的 Webhooks 减少长时任务的摩擦与延迟

- 来源：Google Blog：AI（RSS）
- 作者：Lucia Loher
- 发布时间：2026-05-04 23:30
- AIHOT 分数：71
- AIHOT 标记：精选
- AIHOT 链接：https://aihot.virxact.com/items/cmorqe5i001j9slrjsn0q77zv
- 原文链接：https://blog.google/innovation-and-ai/technology/developers-tools/event-driven-webhooks

## 精选理由

Gemini API 终于补上 Webhooks 这块拼图，长任务不用再轮询等待，对做自动化流程和 Agent 的开发者是实打实的效率提升。

## AI 摘要

Gemini API 引入了事件驱动的 Webhook 功能，这是一种基于推送的通知系统。它旨在消除低效的轮询需求，为长时运行的任务（如文件处理或复杂推理）提供更优的解决方案。当任务完成时，系统会自动将结果推送到用户指定的端点，从而显著降低延迟并减少资源消耗，提升开发效率与响应速度。

## 正文

Reduce friction and latency for long-running jobs with Webhooks in Gemini API

May 04, 2026

We're making it easier and more efficient to build complex, long-running agentic applications with the Gemini API Webhooks.

Lucia Loher

Product Manager, Gemini API

Hussein Hassan Harrirou

Engineering, Gemini API

Listen to article

This content is generated by Google AI. Generative AI is experimental

[[duration]] minutes

Today, we're making it easier and more efficient to build complex, long-running agentic applications with the Gemini API. We are introducing event-driven Webhooks, a push-based notification system that eliminates the need for inefficient polling.

As Gemini shifts toward agentic workflows and high-volume processing — like Deep Research, long video generation, or processing thousands of prompts via the Batch API — operations can take minutes or even hours. Until now, developers had to rely on continuous polling (e.g., repeatedly callingGEToperations) to check if a job was completed.

Now, the Gemini API can simply push a real-time HTTP POST payload to your server the instant a task finishes.

We’ve built this with reliability and security in mind. Our implementation strictly adheres to the Standard Webhooks specification. Every request is signed using webhook-signature, webhook-id, and webhook-timestamp headers, ensuring idempotency and preventing replay attacks. We also guarantee "at-least-once" delivery with automatic retries for up to 24 hours.

How it works

You can configure webhooks globally at the project level (secured via HMAC), or override them dynamically on a per-request basis to route specific jobs (secured via JWKS).

Here's a quick example of how you can dynamically configure a webhook for a batch task using the Python SDK:

Get started today

This feature is available now for all developers using the Gemini API:

Read the guide: Check out the Webhooks documentation to explore the full event catalog and learn how to secure your endpoints.

Hands-on practice: We've prepared a comprehensive Cookbook to help you build an end-to-end integration with webhooks.

POSTED IN: