🇮🇹 IT

📂 Google Drive

Legge o scrive file in Google Drive. Supporta il download del contenuto dei file, il caricamento di nuovi file e l'aggiornamento di file esistenti. Richiede le credenziali OAuth di Google configurate in Impostazioni → Integrazioni.

Categoria: Operazioni su File · Identificatore tipo: google_drive

Panoramica

Il nodo Google Drive collega i workflow Flusso al tuo spazio di archiviazione Google Drive tramite l'API Google Drive. Usalo per importare il contenuto dei file in un workflow per l'elaborazione, generare documenti e caricarli in una posizione condivisa su Drive, o sovrascrivere file esistenti con contenuti aggiornati.

I file sono identificati dal loro File ID di Google Drive, che appare nell'URL di qualsiasi file aperto in Google Drive: https://drive.google.com/file/d/{FILE_ID}/. Per i nuovi caricamenti, puoi opzionalmente specificare una cartella padre usando l'ID della cartella, reperibile nello stesso modo.

Prerequisito: Un account Google deve essere connesso in Impostazioni → Integrazioni prima che questo nodo possa accedere a Google Drive. L'account deve avere almeno permessi di lettura o scrittura per i file e le cartelle che intendi utilizzare.

Configurazione

Campo	Stato	Descrizione
Credential	Obbligatorio	Credenziale dell'account Google da Impostazioni → Integrazioni.
Operation	Obbligatorio	`read` — scarica il contenuto del file. `write` — carica un nuovo file. `update` — sostituisce il contenuto di un file esistente.
File ID	Obbligatorio per read/update	L'ID del file Google Drive da leggere o aggiornare. Lo trovi nell'URL del file: `https://drive.google.com/file/d/{FILE_ID}/`.
Folder ID	Opzionale per write	La cartella padre per i nuovi caricamenti. Predefinito: la radice del tuo Drive.
File Name	Obbligatorio per write	Nome del nuovo file inclusa l'estensione, ad es. `report-2026-03.txt`.
Content	Obbligatorio per write/update	Contenuto da caricare. Supporta riferimenti `{{ variable }}`.
MIME Type	Opzionale per write	Tipo di contenuto del file caricato. Predefinito: `text/plain`. Esempi: `application/json`, `text/csv`.

Dati di Output

Tutte le operazioni restituiscono i seguenti campi.

Campo	Tipo	Descrizione
`content`	string	Contenuto del file (modalita lettura).
`file_id`	string	ID del file Google Drive creato o aggiornato.
`file_name`	string	Nome del file.
`web_url`	string	URL per aprire il file in Google Drive.

Esempio di Utilizzo

Un nodo Agent genera un report di riepilogo dettagliato come risposta testuale.
Un nodo Google Drive con Operation: write carica il report in una cartella condivisa del team, denominando il file report-{{ trigger.output.date }}.txt.
Un nodo Slack Message invia l'output web_url in un canale cosi il team puo esaminarlo immediatamente.

Suggerimenti e Note

Il File ID e il modo piu affidabile per identificare un file. Copialo dall'URL del file in Google Drive anziche fare affidamento sui nomi dei file, che possono cambiare.
I formati nativi di Google Drive (Google Docs, Google Sheets) non possono essere scritti direttamente con questo nodo. Usa Google Sheets per i dati dei fogli di calcolo.
Quando carichi file con write, viene sempre creato un nuovo file. Per sostituire il contenuto di un file esistente, usa update e fornisci il File ID esistente.
L'output web_url e utile per condividere link nei nodi di notifica dopo che un file e stato creato o aggiornato.
Assicurati che l'account Google connesso abbia accesso Editor alla cartella di destinazione quando usi le operazioni write o update.

Nodi Correlati

Google Sheets — legge e scrive dati strutturati nei fogli di calcolo Google Sheets.
Local File — operazioni su file lato server senza credenziali cloud.
Dropbox — archiviazione file cloud alternativa.
Amazon S3 — archiviazione di oggetti scalabile per file di grandi dimensioni.