Интеграция Google объединяет несколько возможностей: Calendar, Sheets, Drive, Google Ads, Google Analytics 4, Search Console, Business Profile и валидация почтовых адресов. Каждая из них подключается независимо (вы предоставляете только нужные scopes), через «Вход через Google» (управляемый OAuth) или ваше собственное приложение.
Calendar (Google Calendar)
- Список событий календаря за период (
google.calendar_list_events, узелgoogle_calendar_list_events) — полезно, чтобы agent знал о вашей доступности. - Создание события (
google.calendar_create_event, узелgoogle_calendar_create_event) — например, для бронирования подтверждённой встречи. - Удаление события (
google.calendar_delete_event) — по его идентификатору. - Запуск pipeline перед событием — приёмник
google_calendar_inboundпериодически опрашивает календарь и может срабатывать только для событий, которые скоро начнутся (напоминание, подготовка к встрече). Мгновенная реакция на изменение календаря недоступна.
Типичное применение: персональный ассистент, который проверяет календарь, предлагает временной слот, а затем создаёт встречу.
Google Sheets
- Чтение таблицы (
google.sheets_read, узелgoogle_sheets_read) — получение строк для обработки в pipeline. - Добавление строк через инструмент
google.sheets_appendили узелgoogle_sheets_append(запись exactly-once). - Публикация таблицы (
google.sheets_publish, узелgoogle_sheets_publish) — создаёт новую таблицу с несколькими листами и возвращает её URL. Внимание: по умолчанию таблица делается публичной.
Типичное применение: логировать каждый запуск pipeline в таблицу-трекер или использовать таблицу как небольшую конфигурационную базу для бизнеса.
Google Drive
- Поиск и чтение файлов (
google.drive_search,google.drive_read), загрузка документа (google.drive_upload), создание папки, перемещение файла, перемещение в корзину (обратимо). - Узлы
google_drive_list/google_drive_download/google_drive_upload— получение списка, скачивание и размещение файлов (загрузка exactly-once). - Наблюдение за папкой — приёмник
google_drive_changesобнаруживает новые файлы в папке (опрос с курсором) и запускает pipeline.
Scope Drive является чувствительным: по умолчанию betool запрашивает доступ только к файлам, которые он создаёт или которые вы ему открываете (drive.file).
Google Ads
- Отчёт о результативности — получение метрик ваших кампаний (
google.ads_report). - Управление кампанией — изменение её дневного бюджета (
google.ads_update_budget) или приостановка / повторная активация (google.ads_update_campaign_status). - Загрузка конверсий — отправка офлайн-конверсий обратно в Google Ads через узел
google_ads_conversion_upload.
Google Analytics 4 и Search Console
- Analytics 4 — отчёт об аудитории ваших ресурсов GA4 (
google.analytics_report, узелgoogle_analytics_report), только чтение. - Search Console — поисковая эффективность ваших сайтов: запросы, страницы, клики, показы (
google.search_console_report, узелgoogle_search_console_report), только чтение.
Google Business Profile
- Отзывы — список отзывов и средняя оценка карточки (
google.gbp_list_reviews, узелgoogle_business_report), а также публичный ответ на отзыв (google.gbp_reply_review). - Публикации — публикация поста в карточке (
google.gbp_create_post, узелgoogle_business_post).
Валидация адресов
Инструмент google.verify_address валидирует и нормализует почтовый адрес (полезно перед физической рассылкой или для очистки карточки клиента).
Подключение (BYO + резервный аккаунт вендора)
- Параметры → Сервисы → Google, вкладка Accounts.
- Подключите каждую нужную вам возможность: «Вход через Google» или учётные данные вашего собственного OAuth-приложения. Для валидации адресов используется API-ключ.
- Только для валидации адресов: если вы не настроили собственный ключ, betool может маршрутизировать вызов через общий ключ вендора (порядок разрешения
ваш ключ > общий ключ).
Все OAuth-возможности выполняются на вашем аккаунте Google, без metering и наценки betool. В кредитах тарифицируется только валидация адресов, проходящая через общий ключ вендора.