🇮🇹 IT

📊 Google Sheets

Legge, scrive, aggiunge, cerca e crea fogli di calcolo Google Sheets. Supporta la lettura di un intervallo di celle, l'aggiunta di nuove righe, l'aggiornamento di celle esistenti, il filtraggio di righe con espressioni e la creazione di nuovi fogli di calcolo. Richiede le credenziali OAuth di Google da Impostazioni → Integrazioni.

Categoria: Operazioni su File · Identificatore tipo: google_sheets

Panoramica

Il nodo Google Sheets si connette all'API di Google Sheets e permette ai workflow di utilizzare un foglio di calcolo come un database leggero, una destinazione per report o una fonte dati. Supporta cinque azioni: leggere un intervallo di celle nel contesto del workflow, aggiungere nuove righe alla fine di una tabella in crescita, sovrascrivere un intervallo specifico di celle con nuovi valori, cercare righe usando un'espressione filtro e creare un nuovo foglio di calcolo.

Le celle sono indirizzate usando la notazione A1 — una lettera di colonna combinata con un numero di riga (ad es. A1:D10 copre le colonne A–D, righe 1–10). Puoi prefissare l'intervallo con il nome di una scheda del foglio e un punto esclamativo per puntare a una scheda specifica (ad es. Sales!A1:D10).

Il foglio di calcolo viene selezionato da un menu a discesa che elenca tutti i fogli accessibili tramite l'account Google collegato. Clicca il pulsante aggiorna accanto al selettore per ricaricare l'elenco da Google Drive se un foglio di calcolo appena creato non è visibile.

Prerequisito: Un account Google deve essere connesso in Impostazioni → Integrazioni prima che questo nodo possa accedere a Google Sheets. L'account deve avere almeno accesso Visualizzatore per le operazioni di lettura e accesso Editor per le operazioni di scrittura o aggiunta.

Configurazione

Campo	Stato	Descrizione
Credential	Obbligatorio	Credenziale dell'account Google da Impostazioni → Integrazioni.
Spreadsheet	Obbligatorio	Seleziona un foglio di calcolo dal menu a discesa. L'elenco viene caricato dal tuo Google Drive collegato. Clicca il pulsante aggiorna per ricaricare l'elenco se un foglio di calcolo appena creato non è presente.
Sheet Name	Opzionale	Nome della scheda del foglio su cui operare. Predefinito: il primo foglio se lasciato vuoto.
Action	Obbligatorio	`read` — recupera un intervallo di celle. `write` — sovrascrive un intervallo specifico. `append` — aggiunge nuove righe alla fine dei dati. `search` — filtra le righe usando un'espressione Symfony ExpressionLanguage. `create` — crea un nuovo foglio di calcolo in Google Drive.
Range	Obbligatorio per read/write	Intervallo in notazione A1, ad es. `A1:D10` o `A:A` per una colonna intera.
Values	Obbligatorio per append/write	Un array 2D di valori da scrivere. Usa `{{ variable }}` per riferire un output di step. Per append, ogni array interno e una riga, ad es. `[["Alice", "30"], ["Bob", "25"]]`.
Value Input Option	Opzionale	`RAW` — i valori vengono memorizzati esattamente come forniti. `USER_ENTERED` — i valori vengono interpretati come se digitati da un utente (formule, date, valuta). Predefinito: `USER_ENTERED`.
Expression	Obbligatorio per search	Un'espressione Symfony ExpressionLanguage valutata per ogni riga. Le righe per cui l'espressione restituisce `true` vengono incluse nell'output. Variabili disponibili: • `row` — la riga come array associativo quando Has Headers è abilitato (le chiavi sono i nomi delle colonne), oppure come array a indice 0 altrimenti. • `rowIndex` — posizione intera a base 0 della riga nel foglio. Esempio: `row["Status"] == "active"`
Has Headers	Opzionale — solo search	Quando abilitato, la prima riga del foglio viene trattata come nomi di colonna e ogni riga successiva viene passata all'espressione come array associativo con chiave per nome di colonna. Predefinito: abilitato.
Title	Obbligatorio per create	Il nome del nuovo foglio di calcolo da creare.
Sheet Names	Opzionale — solo create	Elenco separato da virgole di nomi di schede da creare nel nuovo foglio di calcolo (ad es. `Vendite, Q1, Q2`). Se lasciato vuoto, Google Sheets crea un singolo foglio predefinito denominato "Sheet1".

Dati di Output

I campi di output dipendono dall'azione selezionata. I campi non applicabili all'azione scelta vengono omessi o impostati su null.

Campo	Tipo	Descrizione
`ok`	boolean	Indica se l'azione è stata completata senza errori.
`spreadsheet_id`	string	L'ID del foglio di calcolo su cui è stata eseguita l'operazione. Restituito anche da `create`.
`spreadsheet_url`	string	L'URL del foglio di calcolo nel browser. Restituito da `create`.
`rows`	array	Array 2D di valori delle celle (modalità read) o righe corrispondenti (modalità search). Ogni array interno è una riga.
`row_count`	number	Numero di righe restituite da un'azione `read`.
`matched_count`	number	Numero di righe corrispondenti a un'espressione `search`.
`total_rows`	number	Numero totale di righe dati valutate durante un'azione `search` (esclusa la riga di intestazione quando Has Headers è abilitato).
`updated_range`	string	L'intervallo effettivo in notazione A1 che è stato aggiornato (write/append).
`updated_rows`	number	Numero di righe scritte durante un'azione `write` o `append`.
`created`	boolean	`true` quando l'azione `create` ha creato con successo un nuovo foglio di calcolo.

{{ step_key.output.ok }} {{ step_key.output.spreadsheet_id }} {{ step_key.output.spreadsheet_url }} {{ step_key.output.rows }} {{ step_key.output.row_count }} {{ step_key.output.matched_count }} {{ step_key.output.total_rows }} {{ step_key.output.updated_range }} {{ step_key.output.updated_rows }} {{ step_key.output.created }}

Esempio di Utilizzo

Un nodo Loop itera su una lista di record prodotti da uno step precedente.
All'interno del loop, un nodo Google Sheets con Operation: append scrive ogni record elaborato come una nuova riga nel foglio di calcolo di destinazione.
Dopo il completamento del loop, un nodo Email Notification condivide l'URL del foglio di calcolo con le parti interessate affinche possano esaminare i dati aggiornati.

Suggerimenti e Note

Usa append (non write) quando aggiungi nuove righe a un log o tabella in crescita — trova automaticamente la prima riga vuota e non sovrascrive i dati esistenti.
Seleziona il foglio di calcolo dal menu a discesa. Se un foglio di calcolo appena creato non compare, clicca il pulsante aggiorna per ricaricare l'elenco da Google Drive.
Durante la lettura, le celle vuote alla fine di una riga non vengono restituite dall'API. Controlla la lunghezza dell'array prima di accedere alle celle per indice per evitare errori.
Imposta Value Input Option su USER_ENTERED se vuoi che Google Sheets interpreti stringhe di date, simboli di valuta o formule che iniziano con =.
Per operare su più schede nello stesso workflow, usa più nodi Google Sheets con valori diversi per Sheet Name.
L'azione search valuta l'espressione riga per riga usando Symfony ExpressionLanguage. Abilita Has Headers per accedere alle colonne per nome (ad es. row["Status"]) invece che per indice (ad es. row[2]).
L'azione create crea un nuovo foglio di calcolo nella radice del Google Drive collegato. Puoi fornire nomi di schede separati da virgole in Sheet Names — ad esempio Leads, Archivio crea due schede.

Nodi Correlati

Google Drive — legge e scrive file arbitrari in Google Drive.
Loop — itera sulle righe restituite da un'operazione di lettura.
Transform — riorganizza l'array 2D di valori in oggetti strutturati per un accesso piu semplice.