Урок из полного доступа, первые уроки курса бесплатно Официальный курс Gemini API Cookbook на русском
Урок 50 · Текст · ~5 мин

Вебхуки: уведомления о готовых задачах

Урок 50 из 71 курса «Gemini API: быстрый старт»: официальный курс Gemini API Cookbook (Гугл Джемини) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Предварительная версия: Поддержка Webhooks в Gemini API в настоящее время находится на стадии предварительного просмотра.

Webhooks позволяют Gemini API отправлять уведомления в реальном времени на ваш сервер, когда завершаются асинхронные или длительные операции (LROs). Это устраняет необходимость постоянного опроса API для получения обновлений статуса, уменьшая задержку и накладные расходы.

Webhooks доступны для таких операций, как задания Batch, Interactions и генерация видео.

Вместо многократного опроса GET /operations для проверки завершения задания вы можете настроить Webhooks Gemini API для отправки HTTP POST запроса на ваш URL-адрес прослушивателя немедленно после срабатывания события.

Gemini API поддерживает два способа настройки webhooks:

  • Static webhooks: Эндпоинты уровня проекта. Подходят для глобальных интеграций (например, уведомления Slack, синхронизация базы данных и т. д.).
  • Dynamic webhooks: Переопределения на уровне запроса, передающие webhook URL в конфигурационной полезной нагрузке вызова конкретного задания. Идеально подходят для маршрутизации конкретных заданий на выделенные эндпоинты.

Установите SDK из PyPI.

Чтобы запустить следующий cell, ваш API key должен быть сохранен в Colab Secret с именем GEMINI_API_KEY. Если у вас еще нет API key или вы не знаете, как создать Colab Secret, см. Authentication для пошагового руководства.

Инициализируйте клиент с вашим API key:

В этом примере используется функция Google Cloud Run, которая позволяет легко развернуть бессерверную функцию, которую вы можете использовать в качестве нашего эндпоинта webhook.

  1. Перейдите по ссылке https://console.cloud.google.com/run/
  2. Нажмите NodeJS под "Write a function"
  3. Введите имя, например "gemini-webhook-receiver", и выберите "Allow public access" в разделе Authentication
  4. Нажмите "Deploy". Если вы развертываете функцию Cloud Run впервые, вам может потребоваться включить API, такие как Cloud Build, по запросу.

(Их UI управления по адресу https://console.cloud.google.com/run/ имеет страницу просмотра логов, вы можете видеть запросы там)

  1. Реализация верификации подписи webhook: На вкладке Source обновите зависимости package.json следующим образом:

Обновите точку входа функции на geminiWebhook

и замените код в…

План урока

  1. Как это работает
  2. Установка SDK
  3. Настройка вашего API key
  4. Инициализация клиента SDK
  5. Шаг 1: Создание эндпоинта webhook
  6. Шаг 2: Создание webhook и добавление секрета в функцию Cloud Run
  7. Список
  8. Получить/Проверить/Удалить/Обновить

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы Google Gemini 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от Google Gemini (2 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Урок входит в темы

Полезные гиды