Gemini API の Webhook 機能により、長時間実行ジョブの摩擦と遅延を低減
本文の状態
日本語全文を表示中
詳細モードで約3分の本文を読めます。
同じ出来事の情報源
この情報源を基点に整理
Google AI Blog
Google は Gemini API に Webhook 機能を追加し、開発者が長時間実行されるジョブの処理における待ち時間や複雑さを軽減できるようにした。これにより、非同期タスクの実行効率が向上する。
Source Article
元記事を日本語で読む
本文に関係しない購読案内、埋め込み通知、サイト内プロモーションは除いています。
2026 年 5 月 4 日
1 分間の読み物
Gemini API の Webhooks を使用して、複雑で長時間実行されるエージェント型アプリケーションを構築しやすく、より効率的にしています。
Lucia Loher
Gemini API プロダクトマネージャー
Hussein Hassan Harrirou
Gemini API エンジニアリング
お使いのブラウザは音声再生要素をサポートしていません。
記事の聴読
このコンテンツは Google AI によって生成されています。生成 AI は実験的な技術です。
[[duration]] 分
本日、Gemini API を使用して複雑で長時間実行されるエージェント型アプリケーションを構築しやすく、より効率的にします。非効率なポーリング（polling）の必要性を排除するプッシュ型の通知システムであるイベント駆動型の Webhooks を導入します。
Gemini が Deep Research、長時間の動画生成、または Batch API を通じて数千ものプロンプトを処理するといった、エージェント型ワークフローや高ボリューム処理へとシフトするにつれて、操作には数分甚至いは数時間かかるようになります。これまで開発者は、ジョブが完了したかどうかを確認するために、継続的なポーリング（例：GET 操作の繰り返し呼び出し）に頼る必要がありました。
現在では、Gemini API はタスクが完了した瞬間に、リアルタイムの HTTP POST ペイロードをあなたのサーバーへプッシュすることができます。
この機能は、信頼性とセキュリティを念頭に置いて構築されました。実装は Standard Webhooks 仕様に厳密に従っており、すべてのリクエストは webhook-signature、webhook-id、webhook-timestamp ヘッダーを使用して署名されています。これにより、イデムポテンシー（冪等性）が保証され、リプレイ攻撃が防止されます。また、最大 24 時間にわたる自動再試行機能により、「少なくとも 1 回」の配信を保証します。
仕組み
Webhook は、プロジェクトレベルでグローバルに設定（HMAC によるセキュリティ保護）することもできますし、特定のジョブをルーティングするためにリクエストごとに動的に上書き（JWKS によるセキュリティ保護）することも可能です。
Python SDK を使用してバッチタスクの Webhook を動的に構成する簡単な例は以下の通りです：
今日から始めましょう
この機能は、Gemini API を利用しているすべての開発者向けに現在利用可能です：
- ガイドを読む：Webhooks のドキュメントを確認し、イベントカタログ全体を探索してエンドポイントを保護する方法を学びましょう。
- ハンズオン演習：Webhooks を使用したエンドツーエンドの統合を構築するための包括的な Cookbook を用意しました。
原文を表示
May 04, 2026
1 min read
We're making it easier and more efficient to build complex, long-running agentic applications with the Gemini API Webhooks.
L
Lucia Loher
Product Manager, Gemini API
H
Hussein Hassan Harrirou
Engineering, Gemini API
Your browser does not support the audio element.
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.
関連記事
今日のまとめ
AIデイリーブリーフで今日の重要ニュースをまとめ読み