Gemini API добавил event‑driven Webhooks для уведомлений о завершении долгих задач

Gemini API получил push‑систему Webhooks, которая отправляет HTTP POST на ваш сервер при завершении задач, устраняя постоянный опрос и облегчая работу с длительными agent‑workflow и пакетной обработкой.

4 мая 2026 года в официальном объявлении команды Gemini API представили поддержку event‑driven Webhooks — push‑основанной системы уведомлений для разработчиков. Объявление подписали Lucia Loher (Product Manager, Gemini API) и Hussein Hassan Harrirou (Engineering, Gemini API). Функция позволяет API отправлять HTTP POST‑полезную нагрузку на указанный URL в момент завершения задачи вместо того, чтобы клиент регулярно опрашивал статус через повторные GET‑вызовы. Нововведение ориентировано на сценарии, где результаты приходят не мгновенно: Deep Research, генерация длительных видео и массовая пакетная обработка через Batch API, когда операции могут занимать минуты или часы. Переход на push‑уведомления сокращает задержки в доставке результатов и убирает накладные расходы на непрерывный опрос, что упрощает масштабирование agentic‑workflow и высокообъёмных интеграций.

Реализация следует Standard Webhooks specification и сделана с акцентом на надёжность и безопасность. Каждое уведомление подписывается заголовками webhook‑signature, webhook‑id и webhook‑timestamp для поддержки идемпотентности и предотвращения replay‑атак. Механизм доставки настроен по модели «как минимум один раз» (at‑least‑once) с автоматическими повторными попытками доставки в течение до 24 часов. Для гибкой маршрутизации предусмотрены две модели конфигурации: глобальный webhook на уровне проекта, защищённый через HMAC, и динамическое переопределение webhook прямо в запросе для конкретной задачи, где защита осуществляется через JWKS. Такая схема позволяет сочетать централизованное управление уведомлениями и точечную маршрутизацию для отдельных workflow, не жертвуя безопасностью.

В документации приводят пример настройки динамического webhook для пакетной задачи с использованием Python SDK, а также практический Cookbook с пошаговыми инструкциями по интеграции. Функция уже доступна всем разработчикам; в объявлении указаны ссылки на подробную документацию и примеры интеграции для ускоренного внедрения.