Documentación

Google

Calendar, Sheets, Drive, Google Ads, Analytics 4, Search Console, Business Profile y validación de direcciones — cada capacidad conectada por separado, en BYO.

La integración de Google agrupa varias capacidades: Calendar, Sheets, Drive, Google Ads, Google Analytics 4, Search Console, Business Profile y validación de direcciones postales. Cada una se conecta de forma independiente (solo concedes los ámbitos útiles), con «Iniciar sesión con Google» (OAuth gestionado) o tu propia app.

Calendar (Google Calendar)

  • Listar los eventos de un calendario en un periodo (google.calendar_list_events, nodo google_calendar_list_events) — útil para que un agente conozca tu disponibilidad.
  • Crear un evento (google.calendar_create_event, nodo google_calendar_create_event) — por ejemplo, para fijar una cita confirmada.
  • Eliminar un evento (google.calendar_delete_event) — a partir de su identificador.
  • Disparar un pipeline antes de un evento — el receptor google_calendar_inbound consulta periódicamente el calendario y puede disparar solo para los eventos que empiezan pronto (recordatorio, preparación de una cita). La reacción inmediata a una modificación del calendario no está disponible.

Uso típico: un asistente personal que consulta el calendario, propone una franja horaria y luego crea la cita.

Google Sheets

  • Leer una hoja (google.sheets_read, nodo google_sheets_read) — obtener filas para procesarlas en un pipeline.
  • Añadir filas mediante la herramienta google.sheets_append o el nodo google_sheets_append (escritura exactly-once).
  • Publicar una tabla (google.sheets_publish, nodo google_sheets_publish) — crea un nuevo libro con varias pestañas y devuelve su URL. Atención: el libro se hace público por defecto.

Uso típico: registrar cada ejecución de pipeline en una hoja de seguimiento, o usar una hoja como pequeña base de configuración de negocio.

Google Drive

  • Buscar y leer archivos (google.drive_search, google.drive_read), subir un documento (google.drive_upload), crear una carpeta, mover un archivo, enviar a la papelera (reversible).
  • Nodos google_drive_list / google_drive_download / google_drive_upload — listado, descarga y depósito de archivos (subida exactly-once).
  • Vigilancia de carpeta — el receptor google_drive_changes detecta nuevos archivos en una carpeta (polling con cursor) y dispara un pipeline.

El ámbito de Drive es sensible: por defecto, betool solo solicita acceso a los archivos que crea o que tú le abres (drive.file).

  • Informe de rendimiento — obtén las métricas de tus campañas (google.ads_report).
  • Gestionar una campaña — modificar su presupuesto diario (google.ads_update_budget) o pausarla / reactivarla (google.ads_update_campaign_status).
  • Carga de conversiones — envía conversiones offline a Google Ads mediante el nodo google_ads_conversion_upload.

Google Analytics 4 y Search Console

  • Analytics 4 — informe de audiencia de tus propiedades GA4 (google.analytics_report, nodo google_analytics_report), en solo lectura.
  • Search Console — rendimiento de búsqueda de tus sitios: consultas, páginas, clics, impresiones (google.search_console_report, nodo google_search_console_report), en solo lectura.

Google Business Profile

  • Reseñas — listar las reseñas y la valoración media de una ficha (google.gbp_list_reviews, nodo google_business_report), y responder públicamente a una reseña (google.gbp_reply_review).
  • Publicaciones — publicar un post en la ficha (google.gbp_create_post, nodo google_business_post).

Validación de direcciones

La herramienta google.verify_address valida y normaliza una dirección postal (útil antes de un envío físico o para fiabilizar un registro de cliente).

Conexión (BYO + fallback de proveedor)

  1. Ajustes → Servicios → Google, pestaña Cuentas.
  2. Conecta cada capacidad que necesites: «Iniciar sesión con Google», o las credenciales de tu propia app OAuth. La validación de direcciones utiliza una clave de API.
  3. Solo para la validación de direcciones: si no has configurado tu propia clave, betool puede enrutar la llamada a través de una clave común del proveedor (resolución tu clave > clave compartida).

Todas las capacidades OAuth se ejecutan en tu cuenta de Google, sin medición ni margen de betool. Solo la validación de direcciones que pasa por la clave compartida del proveedor se factura en créditos.