Gemini API, 장기 작업용 Webhooks 도입
·2026.05.05 00:30
Gemini API가 장기 작업용 Webhooks를 도입해 폴링을 없앴다.
Gemini API가 이벤트 기반 Webhooks를 도입해 장기 실행 작업의 상태 확인에 필요한 반복 폴링을 줄였다. 작업이 끝나는 즉시 서버로 HTTP POST 알림을 보내며, Deep Research나 긴 영상 생성, Batch API로 수천 개 프롬프트를 처리하는 흐름에 맞췄다.
보안과 신뢰성도 함께 강화했다. 요청은 Standard Webhooks 사양을 따르며 webhook-signature, webhook-id, webhook-timestamp 헤더로 서명돼 idempotency를 보장하고 replay attack을 막는다. 전달은 at-least-once 방식으로 이뤄지며 자동 재시도는 최대 24시간 지속된다.
설정 방식은 두 가지다.
- 프로젝트 전역 Webhook: HMAC 기반
- 요청별 Webhook 오버라이드: JWKS 기반
이 기능은 현재 Gemini API 개발자 전원에게 제공되며, 공식 Webhooks 문서와 Cookbook 예제로 바로 연동할 수 있다.
이 요약은 원문 이해를 돕기 위한 큐레이션입니다. 저작권은 원저작자에게 있으며, 정확한 내용과 맥락은 원문을 확인하세요.
요약 오류, 출처 표기 문제, 삭제 요청은 문의 · 건의로 알려주세요.