Gemini API にイベント駆動 Webhook が追加——長時間ジョブのポーリング不要に

記事のサマリー（TL;DR）

• Gemini API がイベント駆動 Webhook を正式リリース（2026年5月4日）、ポーリング不要でジョブ完了を即時通知
• Standard Webhooks 仕様に準拠し、HMAC / JWKS による署名検証・リプレイアタック防止・24時間自動リトライを保証
• Deep Research・長尺動画生成・Batch API による大量プロンプト処理など、分〜時間単位のエージェント系ワークフローが対象

Gemini API の Webhook を活用する日本の開発者・SaaS 事業者が押さえるポイント

Gemini API の Batch API や Deep Research はすでに日本のデベロッパーも利用できる状態にあります。今回の Webhook 追加により、数千件のプロンプトを一括処理するバッチジョブや、長尺動画の生成完了を自分のサーバーにプッシュで受け取れるようになります。kintone や Salesforce のバックエンドとして Gemini の非同期処理を組み込んでいる構成では、これまで定期的な GET ポーリングで実装していた完了確認ロジックを Webhook 受信に置き換えることで、サーバーコストと応答レイテンシの双方を削減できます。Standard Webhooks 仕様への準拠は、既存の Webhook 検証ライブラリ（Python SDK 含む）をそのまま流用できる点でも実装コストが低く抑えられます。

詳細

イベント駆動 Webhook とは何か

Google は 2026年5月4日、Gemini API にイベント駆動 Webhook（Event-Driven Webhooks）を導入しました。これはプッシュ型の通知システムで、エージェント型ワークフローや大量バッチ処理における非効率なポーリングを排除することを目的としています。

Gemini がエージェント型ワークフローや高ボリューム処理——Deep Research、長尺動画生成、Batch API 経由の数千件プロンプト処理——へとシフトするにつれ、処理時間は数分から数時間に及ぶケースが増えています。従来、開発者は GET リクエストを繰り返して完了確認（ポーリング）を行う必要がありました。今回の Webhook 対応により、Gemini API がタスク完了の瞬間にサーバーへリアルタイムで HTTP POST ペイロードをプッシュします。

セキュリティと信頼性の設計

本実装は Standard Webhooks 仕様に厳密に準拠しています。主な特徴は以下の通りです。

• 署名検証: webhook-signature・webhook-id・webhook-timestamp ヘッダーを使用し、冪等性（idempotency）を確保
• リプレイアタック防止: タイムスタンプ検証による不正リクエストの排除
• “At-least-once” 配信保証: 最大 24 時間の自動リトライ機能を内蔵

設定方法

Webhook の設定には 2 つのスコープが用意されています。

Python SDK を用いてバッチタスクに動的に Webhook を設定する実装例が公式ドキュメントで提供されています。

今すぐ始める

本機能は Gemini API を利用するすべての開発者に対して即日提供されています。

• 公式ガイド: Webhooks ドキュメントでイベントカタログの全容とエンドポイントのセキュア化手順を確認できます
• ハンズオン: エンドツーエンドの統合を構築するための Cookbook（包括的なサンプル集）が公開されています