betool betool

Dokumentation

Google

Calendar, Sheets, Drive, Google Ads und Validierung von Postanschriften — unter einem einzigen Konnektor, im BYO-Modus.

Google

Die Google-Integration bündelt mehrere Fähigkeiten unter einem einzigen Konnektor: Calendar, Sheets, Drive, Google Ads und Validierung von Postanschriften. Jede wird unabhängig nach Ihrem Bedarf aktiviert, mit einer Verbindung per „Mit Google anmelden“ (verwaltetes OAuth) oder Ihrer eigenen App.

Calendar (Google Calendar)

  • Die Ereignisse eines Kalenders über einen Zeitraum auflisten (google.calendar_list_events) — nützlich, damit ein Agent Ihre Verfügbarkeit kennt.
  • Ein Ereignis erstellen über den Knoten google_calendar_create_event — zum Beispiel, um einen bestätigten Termin zu buchen.

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) — 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).
  • Knoten google_sheets_read — deterministisches Lesen eines Bereichs, in den Kontext veröffentlicht.

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_*), ein Dokument hochladen, Dateien in einem Ordner verwalten.
  • Knoten google_drive_list / google_drive_upload — Dateien auflisten 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: Beschränken Sie den Zugriff auf die strikt notwendigen Ordner.

  • Leistungsbericht — rufen Sie die Metriken Ihrer Kampagnen ab (google.ads_report).
  • Conversion-Upload — übertragen Sie Offline-Conversions zurück an Google Ads über einen dedizierten Knoten.

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. Administration → Integrationen → Google.
  2. Geben Sie Ihre Google-Zugangsdaten ein (API-Schlüssel für die Adressvalidierung; OAuth-Konto für Calendar und Ads).
  3. Auflösung Ihr Konto > gemeinsames Konto: Wenn Sie keinen eigenen Zugriff konfiguriert haben, kann betool bestimmte Aufrufe über ein gepooltes Anbieterkonto leiten.

Metering fällt nur an, wenn der Aufruf über das gemeinsame Anbieterkonto läuft (z. B. Adressvalidierung über den gepoolten Schlüssel). Auf Ihrem eigenen Konto (BYO) zahlen Sie direkt an Google, ohne betool-Marge.