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, Knotengoogle_calendar_list_events) — nützlich, damit ein Agent Ihre Verfügbarkeit kennt. - Ein Ereignis erstellen (
google.calendar_create_event, Knotengoogle_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_inboundliest 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, Knotengoogle_sheets_read) — Zeilen abrufen, um sie in einer Pipeline zu verarbeiten. - Zeilen anhängen über das Tool
google.sheets_appendoder den Knotengoogle_sheets_append(Exactly-once-Schreibvorgang). - Eine Tabelle veröffentlichen (
google.sheets_publish, Knotengoogle_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_changeserkennt 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).
Google Ads
- 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, Knotengoogle_analytics_report), nur lesend. - Search Console — Suchleistung Ihrer Websites: Suchanfragen, Seiten, Klicks, Impressionen (
google.search_console_report, Knotengoogle_search_console_report), nur lesend.
Google Business Profile
- Bewertungen — die Bewertungen und die Durchschnittsnote eines Eintrags auflisten (
google.gbp_list_reviews, Knotengoogle_business_report) und öffentlich auf eine Bewertung antworten (google.gbp_reply_review). - Beiträge — einen Beitrag im Eintrag veröffentlichen (
google.gbp_create_post, Knotengoogle_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)
- Einstellungen → Services → Google, Reiter Konten.
- Verbinden Sie jede benötigte Fähigkeit: „Mit Google anmelden“ oder die Zugangsdaten Ihrer eigenen OAuth-App. Die Adressvalidierung verwendet einen API-Schlüssel.
- 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.