Gemini API の Webhooks で長時間実行ジョブの摩擦と遅延を削減

本日、Gemini API を用いて複雑で長時間実行されるエージェント型アプリケーションを構築する際、より容易かつ効率的になるよう取り組みを行いました。私たちは、非効率なポーリングの必要性を排除するプッシュ型の通知システムであるイベント駆動 Webhooks を導入します。 Gemini が Deep Research や長編動画生成、Batch API を通じて数千ものプロンプトを処理するなど、エージェント型ワークフローや高ボリューム処理へと移行するにつれ、操作には数分乃至数時間かかることもあります。これまで開発者は、ジョブが完了したかを確認するために継続的なポーリング（例：GET 操作の繰り返し呼び出し）に頼る必要がありました。 今後は、Gemini API はタスクが完了した瞬間に、リアルタイムの HTTP POST ペイロードを直接サーバーへプッシュできるようになります。 この機能は信頼性とセキュリティを念頭に構築されました。実装は「Webhooks 仕様」に厳密に従っており、すべてのリクエストは webhook-signature、webhook-id、webhook-timestamp ヘッダーを使用して署名され、冪等性が保証されるとともにリプレイ攻撃が防止されます。また、最大 24 時間にわたる自動再試行により、「少なくとも 1 回」の配信を保証します。 Webhooks はプロジェクトレベルでグローバルに設定可能（HMAC によって保護）であり、特定のジョブをルーティングするために個別のリクエスト単位で動的に上書きすることも可能です（JWKS によって保護）。 Python SDK を使用してバッチタスクに対して Webhook を動的に構成する簡単な例を示します： python from google import genai from google.genai import types client = genai.Client() file_batch_job = client.batches.create( model="gemini-3-flash-preview", src=inline_requests, config={ "display_name": "My Setup", "webhook_config": { "uris": ["https://my-api.com/gemini-webhook-dynamic"], "user_metadata": {"job_group": "nightly-eval", "priority": "high"}, }, }, ) print(f"Created batch job: {file_batch_job.name}") この機能は、Gemini API を利用するすべての開発者に対して現在利用可能です: - ガイドを読む：イベントカタログ全体を確認し、エンドポイントをどのように保護するかを学ぶには、こちらをご覧ください。 - ハンズオン演習：Webhook を使用したエンドツーエンドの統合を構築するための包括的なガイドを用意しました。

Gemini API の Webhooks で長時間実行ジョブの摩擦と遅延を削減

背景や根拠まで確認しますか？

関連記事

調べる

選ぶ

サイト