Dokumentation

Google

Calendar, Sheets, Drive, Google Ads, Analytics 4, Search Console, Business Profile und Adressvalidierung — jede Fähigkeit einzeln verbunden, im BYO-Modus.

Die Google-Integration bündelt mehrere Fähigkeiten: Calendar, Sheets, Drive, Google Ads, Google Analytics 4, Search Console, Business Profile und Validierung von Postanschriften. Jede wird unabhängig verbunden (Sie gewähren nur die nötigen Scopes), per „Mit Google anmelden“ (verwaltetes OAuth) oder mit Ihrer eigenen App.

Calendar (Google Calendar)

  • Die Ereignisse eines Kalenders über einen Zeitraum auflisten (google.calendar_list_events, Knoten google_calendar_list_events) — nützlich, damit ein Agent Ihre Verfügbarkeit kennt.
  • Ein Ereignis erstellen (google.calendar_create_event, Knoten google_calendar_create_event) — zum Beispiel, um einen bestätigten Termin zu buchen.
  • Ein Ereignis löschen (google.calendar_delete_event) — anhand seiner Kennung.
  • Eine Pipeline vor einem Ereignis auslösen — der Empfänger google_calendar_inbound liest den Kalender periodisch aus und kann nur für Ereignisse auslösen, die bald beginnen (Erinnerung, Terminvorbereitung). Eine sofortige Reaktion auf eine Kalenderänderung ist nicht verfügbar.

Typischer Einsatz: ein persönlicher Assistent, der den Kalender prüft, einen Zeitraum vorschlägt und dann den Termin erstellt.

Google Sheets

  • Ein Sheet lesen (google.sheets_read, Knoten google_sheets_read) — Zeilen abrufen, um sie in einer Pipeline zu verarbeiten.
  • Zeilen anhängen über das Tool google.sheets_append oder den Knoten google_sheets_append (Exactly-once-Schreibvorgang).
  • Eine Tabelle veröffentlichen (google.sheets_publish, Knoten google_sheets_publish) — erstellt eine neue Arbeitsmappe mit mehreren Tabellenblättern und liefert deren URL. Achtung: Die Arbeitsmappe wird standardmäßig öffentlich gemacht.

Typischer Einsatz: jeden Pipeline-Lauf in ein Tracking-Sheet protokollieren oder ein Sheet als kleine geschäftliche Konfigurationsbasis verwenden.

Google Drive

  • Dateien suchen und lesen (google.drive_search, google.drive_read), ein Dokument hochladen (google.drive_upload), einen Ordner erstellen, eine Datei verschieben, in den Papierkorb verschieben (umkehrbar).
  • Knoten google_drive_list / google_drive_download / google_drive_upload — Dateien auflisten, abrufen und ablegen (Upload exactly-once).
  • Ordnerüberwachung — der Receiver google_drive_changes erkennt neue Dateien in einem Ordner (Polling mit einem Cursor) und löst eine Pipeline aus.

Der Drive-Scope ist sensibel: Standardmäßig fordert betool nur den Zugriff auf die Dateien an, die es selbst erstellt oder die Sie ihm öffnen (drive.file).

  • Leistungsbericht — rufen Sie die Metriken Ihrer Kampagnen ab (google.ads_report).
  • Eine Kampagne steuern — ihr Tagesbudget ändern (google.ads_update_budget) oder sie pausieren / reaktivieren (google.ads_update_campaign_status).
  • Conversion-Upload — übertragen Sie Offline-Conversions zurück an Google Ads über den Knoten google_ads_conversion_upload.

Google Analytics 4 und Search Console

  • Analytics 4 — Reichweitenbericht Ihrer GA4-Properties (google.analytics_report, Knoten google_analytics_report), nur lesend.
  • Search Console — Suchleistung Ihrer Websites: Suchanfragen, Seiten, Klicks, Impressionen (google.search_console_report, Knoten google_search_console_report), nur lesend.

Google Business Profile

  • Bewertungen — die Bewertungen und die Durchschnittsnote eines Eintrags auflisten (google.gbp_list_reviews, Knoten google_business_report) und öffentlich auf eine Bewertung antworten (google.gbp_reply_review).
  • Beiträge — einen Beitrag im Eintrag veröffentlichen (google.gbp_create_post, Knoten google_business_post).

Adressvalidierung

Das Tool google.verify_address validiert und normalisiert eine Postanschrift (nützlich vor einem physischen Versand oder um einen Kundendatensatz zu bereinigen).

Verbindung (BYO + Anbieter-Fallback)

  1. Einstellungen → Services → Google, Reiter Konten.
  2. Verbinden Sie jede benötigte Fähigkeit: „Mit Google anmelden“ oder die Zugangsdaten Ihrer eigenen OAuth-App. Die Adressvalidierung verwendet einen API-Schlüssel.
  3. Nur für die Adressvalidierung: Wenn Sie keinen eigenen Schlüssel konfiguriert haben, kann betool den Aufruf über einen gepoolten Anbieterschlüssel leiten (Auflösung Ihr Schlüssel > gemeinsamer Schlüssel).

Alle OAuth-Fähigkeiten laufen auf Ihrem Google-Konto, ohne Metering und ohne betool-Marge. Nur die Adressvalidierung über den gemeinsamen Anbieterschlüssel wird in Credits abgerechnet.