Google ogłosiło 4 maja 2026 roku wprowadzenie Webhooks do Gemini API — systemu powiadomień opartego na modelu push, który zastępuje dotychczasowe odpytywanie serwera (polling). Kluczową funkcją jest możliwość wysyłania przez API żądania HTTP POST bezpośrednio na serwer dewelopera w momencie zakończenia zadania. Funkcja jest dostępna od razu dla wszystkich deweloperów korzystających z Gemini API.

Treść przygotowana przez AI

Jest to krótka charakterystyka przygotowana przez AI i pełni funkcję informacyjną, a nie interpretacyjną. Ludzka praca kończy się tutaj na selekcji newsów, z którymi z tych czy innych powodów warto się moim zdaniem zapoznać. Opis nowinki powinien pomóc w ocenie, czy news jest interesujący i warto dalej go eksplorować (do czego oczywiście zachęcam!).

Jak działają Webhooks w Gemini API

  • System działa w modelu push — API wysyła żądanie HTTP POST na wskazany endpoint w momencie zakończenia zadania
  • Implementacja jest zgodna ze specyfikacją Standard Webhooks
  • Każde żądanie jest podpisywane nagłówkami: webhook-signature, webhook-id oraz webhook-timestamp
  • Mechanizm zapewnia idempotentność i ochronę przed atakami typu replay
  • Dostarczenie wiadomości gwarantowane jest co najmniej raz (at-least-once delivery) z automatycznymi próbami ponowienia przez 24 godziny
  • Konfiguracja możliwa na dwóch poziomach: globalnie dla projektu (zabezpieczenie przez HMAC) lub per-żądanie (zabezpieczenie przez JWKS)
  • Dostępne dla wszystkich deweloperów korzystających z Gemini API — bez dodatkowych wymagań dotyczących planu

Polling jako wcześniejszy standard w długich zadaniach API

Przed wprowadzeniem Webhooks deweloperzy korzystający z Gemini API musieli samodzielnie odpytywać serwer (polling) za pomocą powtarzanych wywołań GET, aby sprawdzić status trwającego zadania. Operacje takie jak Deep Research, generowanie długich materiałów wideo czy przetwarzanie tysięcy promptów przez Batch API mogą trwać od kilku minut do kilku godzin.

Model push znany jest z innych systemów integracyjnych — stosują go m.in. platformy płatnicze, systemy CI/CD czy narzędzia do automatyzacji. Gemini API dołącza do tej grupy wraz z rozwojem funkcji agentic workflows i wysokowolumenowego przetwarzania danych.

Źródła

  1. Reduce friction and latency for long-running jobs with Webhooks in Gemini API — The Keyword (Google)

O autorze

Nazywam się Michał Małysa i od wielu lat zajmuję się zawodowo SEO oraz analizą treści, a od 2023 roku w zakres moich obowiązków i zainteresowań dość naturalnie weszło AI. Na stronie MałySEO porządkuję wiedzę o pozycjonowaniu stron internetowych, AI Search oraz działaniu LLM-ów. Prowadzę również MałySEO Newsletter, do którego subskrypcji serdecznie Cię zachęcam na podstronie najlepszego w Polsce newslettera SEO.

Jako że przygotowanie materiałów do MałySEO Newslettera oraz na bloga zajmuje nieco czasu, może zaświtać Ci w głowie dość miły z mojej perspektywy pomysł drobnego rewanżu. Jeżeli uznasz, że lektura tego wpisu była dla Ciebie czymś więcej, niż tylko szybkim odklepaniem randomowej internetowej treści, możesz postawić mi kawkę na buycoffee.to. Z góry dziękuję!

Postaw mi kawę na buycoffee.to

Jeżeli z jakiegoś powodu potrzebujesz się ze mną skontaktować, wyślij mail na adres kontakt[at]michalmalysa.pl