Документация

Google

Calendar, Sheets, Drive, Google Ads, Analytics 4, Search Console, Business Profile и проверка почтовых адресов — каждая возможность подключается отдельно.

Интеграция 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_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 + резервный аккаунт вендора)

  1. Параметры → Сервисы → Google, вкладка Accounts.
  2. Подключите каждую нужную вам возможность: «Вход через Google» или учётные данные вашего собственного OAuth-приложения. Для валидации адресов используется API-ключ.
  3. Только для валидации адресов: если вы не настроили собственный ключ, betool может маршрутизировать вызов через общий ключ вендора (порядок разрешения ваш ключ > общий ключ).

Все OAuth-возможности выполняются на вашем аккаунте Google, без metering и наценки betool. В кредитах тарифицируется только валидация адресов, проходящая через общий ключ вендора.