Google Sheets
Il collegamento avviene come per gli altri account Google in Siesta AI (OAuth).
Panoramica
Questo documento descrive le integrazioni disponibili con i servizi Google:
- GoogleSearch (Custom Search JSON API)
- GoogleSheets (operazioni su fogli di calcolo)
Le integrazioni sono progettate come operazioni deterministiche, senza stato, adatte per automazione, reporting e pipeline di dati.
1. Integrazione Google Search
Nome del servizio
GoogleSearch
Operazioni
Ricerca
Descrizione
Esegue ricerche utilizzando Google Custom Search JSON API.
Parametri di input
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| query | String | Sì | Query di ricerca fornita all'API di Google. |
Comportamento
- Restituisce risultati in base alla configurazione del Custom Search Engine (CSE).
- Rispetta i limiti e le quote dell'API di Google.
- Non esegue alcuna interpretazione o filtraggio dei risultati.
Utilizzo tipico
- Analisi di mercato
- Monitoraggio dei marchi
- Ricerca automatizzata
- Arricchimento dei dati
2. Integrazione Google Sheets
Nome del servizio
GoogleSheets
Descrizione
L'integrazione consente la creazione, la ricerca e l'aggiornamento di Google Spreadsheet. Viene utilizzata come un leggero archivio dati o obiettivo di esportazione per processi automatizzati.
2.1 CreateSheetAsync
Descrizione
Crea un nuovo Google Spreadsheet con colonne specificate.
Parametri di input
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| name | String | Sì | Nome del foglio di calcolo. |
| columnNames | String | Sì | Elenco dei nomi delle colonne separati da virgola. |
Comportamento
- Se il foglio di calcolo con il nome specificato non esiste, viene creato.
- Le colonne vengono inizializzate nella prima riga.
Utilizzo tipico
- Inizializzazione di report
- Preparazione della struttura dei dati per la scrittura successiva
2.2 GetSheetAsync
Descrizione
Cerca un Google Spreadsheet esistente in base al nome.
Parametri di input
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| name | String | Sì | Nome del foglio di calcolo. |
Comportamento
- Restituisce i metadati del foglio di calcolo.
- Se il foglio di calcolo non esiste, l'operazione fallisce.
2.3 UpdateSheetAsync
Descrizione
Sostituisce il contenuto di un foglio di calcolo esistente con dati in formato CSV.
Parametri di input
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| name | String | Sì | Nome del foglio di calcolo. |
| csvContent | String | Sì | Dati CSV da scrivere. Se il campo contiene una virgola, deve essere tra virgolette. |
Comportamento
- Sostituisce completamente il contenuto esistente.
- Non esegue la validazione del tipo di dato.
- La responsabilità per il corretto formato CSV è a carico del chiamante.
Utilizzo tipico
- Esportazione di dati
- Sincronizzazione di report
- Riscrittura automatica delle uscite della pipeline
Note di sicurezza
- L'integrazione avviene esclusivamente tramite l'API ufficiale di Google.
- Nessuna credenziale di accesso diretta viene esposta.
- I diritti di accesso sono gestiti a livello di account Google o di service account.
Decisioni di design
- Operazioni senza stato senza cache e stato condiviso.
- Nomi espliciti: il foglio di calcolo è identificato dal nome, non dall'ID.
- Approccio fail-fast: dati non coerenti portano a un errore.
Riepilogo
- GoogleSearch fornisce ricerche deterministiche tramite Google Custom Search JSON API.
- GoogleSheets copre la creazione, la ricerca e l'aggiornamento dei fogli di calcolo.
- Il formato dei dati e i permessi sono completamente sotto la responsabilità del sistema chiamante.