Documentation

Google

Agenda, Sheets, Drive, Google Ads, Analytics 4, Search Console, Business Profile et validation d'adresse postale — chaque capacité connectée indépendamment, en BYO.

Google

L'intégration Google regroupe plusieurs capacités : Agenda, Sheets, Drive, Google Ads, Google Analytics 4, Search Console, Business Profile et validation d'adresse postale. Chacune se connecte indépendamment (vous n'accordez que les portées utiles), avec « Se connecter avec Google » (OAuth managé) ou votre propre app.

Agenda (Google Calendar)

  • Lister les événements d'un agenda sur une période (google.calendar_list_events, nœud google_calendar_list_events) — utile pour qu'un agent connaisse vos disponibilités.
  • Créer un événement (google.calendar_create_event, nœud google_calendar_create_event) — par exemple poser un rendez-vous confirmé.
  • Supprimer un événement (google.calendar_delete_event) — à partir de son identifiant.
  • Déclencher un pipeline avant un événement — le récepteur google_calendar_inbound relève périodiquement l'agenda et peut ne déclencher que pour les événements qui commencent bientôt (rappel, préparation de rendez-vous). La réaction immédiate à une modification d'agenda n'est pas disponible.

Usage type : un assistant personnel qui consulte l'agenda, propose un créneau, puis crée le rendez-vous.

Google Sheets

  • Lire une feuille (google.sheets_read, nœud google_sheets_read) — récupérer des lignes pour les traiter dans un pipeline.
  • Ajouter des lignes via le tool google.sheets_append ou le nœud google_sheets_append (écriture exactly-once).
  • Publier un tableau (google.sheets_publish, nœud google_sheets_publish) — crée un nouveau classeur multi-onglets et en rend l'URL. Attention : le classeur est rendu public par défaut.

Usage type : journaliser chaque exécution d'un pipeline dans une feuille de suivi, ou utiliser une feuille comme petite base de configuration métier.

Google Drive

  • Rechercher et lire des fichiers (google.drive_search, google.drive_read), téléverser un document (google.drive_upload), créer un dossier, déplacer un fichier, mettre à la corbeille (réversible).
  • Nœuds google_drive_list / google_drive_download / google_drive_upload — listage, récupération et dépôt de fichiers (upload en exactly-once).
  • Veille de dossier — le receiver google_drive_changes détecte les nouveaux fichiers d'un dossier (polling avec curseur) et déclenche un pipeline.

La portée Drive est sensible : par défaut, betool ne demande que l'accès aux fichiers qu'il crée ou que vous lui ouvrez (drive.file).

  • Rapport de performances — récupérer les métriques de vos campagnes (google.ads_report).
  • Piloter une campagne — modifier son budget quotidien (google.ads_update_budget) ou la mettre en pause / la réactiver (google.ads_update_campaign_status).
  • Upload de conversions — remonter des conversions hors ligne vers Google Ads via le nœud google_ads_conversion_upload.

Google Analytics 4 et Search Console

  • Analytics 4 — rapport d'audience de vos propriétés GA4 (google.analytics_report, nœud google_analytics_report), en lecture seule.
  • Search Console — performances de recherche de vos sites : requêtes, pages, clics, impressions (google.search_console_report, nœud google_search_console_report), en lecture seule.

Google Business Profile

  • Avis — lister les avis et la note moyenne d'une fiche (google.gbp_list_reviews, nœud google_business_report), et répondre publiquement à un avis (google.gbp_reply_review).
  • Publications — publier un post sur la fiche (google.gbp_create_post, nœud google_business_post).

Validation d'adresse

Le tool google.verify_address valide et normalise une adresse postale (utile avant un envoi physique ou pour fiabiliser une fiche client).

Connexion (BYO + fallback vendor)

  1. Paramètres → Services → Google, onglet Comptes.
  2. Connectez chaque capacité dont vous avez besoin : « Se connecter avec Google », ou les identifiants de votre propre app OAuth. La validation d'adresse utilise une clé API.
  3. Pour la validation d'adresse uniquement : si vous n'avez pas configuré votre propre clé, betool peut router l'appel via une clé vendor mutualisée (résolution votre clé > clé partagée).

Toutes les capacités OAuth s'exécutent sur votre compte Google, sans metering ni marge betool. Seule la validation d'adresse passée par la clé vendor partagée est facturée en crédits.