Google

L'integrazione Google raggruppa diverse funzionalità: Calendar, Sheets, Drive, Google Ads, Google Analytics 4, Search Console, Business Profile e validazione degli indirizzi postali. Ciascuna si connette in modo indipendente (concedi solo gli scope utili), con « Accedi con Google » (OAuth gestito) o la tua stessa app.

Calendar (Google Calendar)

• Elencare gli eventi di un calendario in un periodo (google.calendar_list_events, nodo google_calendar_list_events) — utile affinché un agent conosca la tua disponibilità.
• Creare un evento (google.calendar_create_event, nodo google_calendar_create_event) — ad esempio, per fissare un appuntamento confermato.
• Eliminare un evento (google.calendar_delete_event) — a partire dal suo identificativo.
• Attivare una pipeline prima di un evento — il ricevitore google_calendar_inbound controlla periodicamente il calendario e può attivarsi solo per gli eventi che iniziano a breve (promemoria, preparazione di un appuntamento). La reazione immediata a una modifica del calendario non è disponibile.

Uso tipico: un assistente personale che controlla il calendario, propone una fascia oraria e poi crea l'appuntamento.

Google Sheets

• Leggere un foglio (google.sheets_read, nodo google_sheets_read) — recupera le righe per elaborarle in una pipeline.
• Aggiungere righe tramite lo strumento google.sheets_append o il nodo google_sheets_append (scrittura exactly-once).
• Pubblicare una tabella (google.sheets_publish, nodo google_sheets_publish) — crea una nuova cartella di lavoro con più fogli e ne restituisce l'URL. Attenzione: la cartella di lavoro è resa pubblica per impostazione predefinita.

Uso tipico: registrare ogni esecuzione della pipeline in un foglio di tracciamento, oppure usare un foglio come piccola base di configurazione aziendale.

Google Drive

• Cercare e leggere file (google.drive_search, google.drive_read), caricare un documento (google.drive_upload), creare una cartella, spostare un file, spostare nel cestino (reversibile).
• Nodi google_drive_list / google_drive_download / google_drive_upload — elenco, recupero e deposito di file (upload exactly-once).
• Monitoraggio di una cartella — il receiver google_drive_changes rileva nuovi file in una cartella (polling con cursore) e attiva una pipeline.

Google Ads

• Report sulle performance — recupera le metriche delle tue campagne (google.ads_report).
• Gestire una campagna — modificarne il budget giornaliero (google.ads_update_budget) o metterla in pausa / riattivarla (google.ads_update_campaign_status).
• Upload di conversioni — invia le conversioni offline a Google Ads tramite il nodo google_ads_conversion_upload.

Google Analytics 4 e Search Console

• Analytics 4 — report sull'audience delle tue proprietà GA4 (google.analytics_report, nodo google_analytics_report), in sola lettura.
• Search Console — performance di ricerca dei tuoi siti: query, pagine, clic, impressioni (google.search_console_report, nodo google_search_console_report), in sola lettura.

Google Business Profile

• Recensioni — elencare le recensioni e la valutazione media di una scheda (google.gbp_list_reviews, nodo google_business_report), e rispondere pubblicamente a una recensione (google.gbp_reply_review).
• Pubblicazioni — pubblicare un post sulla scheda (google.gbp_create_post, nodo google_business_post).

Validazione degli indirizzi

Lo strumento google.verify_address valida e normalizza un indirizzo postale (utile prima di un invio postale fisico o per ripulire un record cliente).

Connessione (BYO + fallback vendor)

1. Impostazioni → Servizi → Google, scheda Account.
2. Collega ogni funzionalità di cui hai bisogno: « Accedi con Google », oppure le credenziali della tua app OAuth. La validazione degli indirizzi utilizza una chiave API.
3. Solo per la validazione degli indirizzi: se non hai configurato la tua chiave, betool può instradare la chiamata attraverso una chiave vendor condivisa (risoluzione la tua chiave > chiave condivisa).