🇮🇹 IT

👁️ Google Drive Watch

Esegue il polling di una cartella Google Drive a intervalli regolari e avvia un'esecuzione del workflow ogni volta che appare un nuovo file. Richiede le credenziali OAuth di Google configurate in Impostazioni → Integrazioni.

Categoria: Trigger · Identificatore tipo: google_drive_watch

Panoramica

Molti processi aziendali si basano sul caricamento di file: un partner carica un report in una cartella condivisa, un membro del team salva una fattura, o un sistema automatizzato esporta un CSV. Il trigger Google Drive Watch trasforma questi caricamenti manuali in trigger automatici per il workflow — non appena un nuovo file appare nella cartella monitorata, Flusso avvia il tuo workflow con i dettagli del file pronti all'uso.

Flusso usa il polling per rilevare nuovi file. All'intervallo che configuri (predefinito ogni 5 minuti), Flusso controlla la cartella alla ricerca di file apparsi dall'ultimo controllo. Quando vengono trovati uno o piu nuovi file, viene avviata un'esecuzione separata del workflow per ogni nuovo file. Se non vengono trovati nuovi file, non succede nulla fino al prossimo polling.

Questo trigger richiede che il tuo account Google sia connesso in Flusso. Naviga su Impostazioni → Integrazioni e connetti il tuo account Google prima di configurare questo trigger. Una volta connesse, le credenziali vengono memorizzate in modo sicuro e riutilizzate in tutti i workflow Google Drive.

Configurazione

Campo	Stato	Descrizione
Credential	Obbligatorio	Credenziale dell'account Google da Impostazioni → Integrazioni.
Folder ID	Obbligatorio	L'ID della cartella Google Drive da monitorare. Lo trovi nell'URL quando navighi alla cartella: `https://drive.google.com/drive/folders/{FOLDER_ID}`
Poll Interval	Opzionale	Ogni quanto controllare la presenza di nuovi file, in minuti. Predefinito: 5. Minimo: 1.
File Type Filter	Opzionale	Tipi MIME separati da virgola da monitorare, ad es. `application/pdf,image/jpeg`. Lascia vuoto per monitorare tutti i tipi di file.

Dati di Output

Ogni esecuzione del workflow attivata da questo nodo riceve i seguenti campi che descrivono il file appena rilevato.

Campo	Tipo	Descrizione
`file.id`	string	ID del file Google Drive
`file.name`	string	Nome del file inclusa l'estensione
`file.mime_type`	string	Tipo MIME del file
`file.size`	number	Dimensione del file in byte
`file.created_at`	string	Timestamp di creazione ISO 8601
`file.web_url`	string	URL per aprire il file in Google Drive

{{ trigger.output.file.id }} {{ trigger.output.file.name }} {{ trigger.output.file.mime_type }} {{ trigger.output.file.size }} {{ trigger.output.file.created_at }} {{ trigger.output.file.web_url }}

Esempio di Utilizzo

Monitora una cartella per nuove fatture PDF, poi scaricale ed elaborale.

Aggiungi un trigger Google Drive Watch. Imposta il Folder ID sull'ID della tua cartella fatture, imposta Poll Interval su 5 e imposta File Type Filter su application/pdf.
Aggiungi un nodo Google Drive in lettura. Passa {{ trigger.output.file.id }} come file ID per scaricare il PDF rilevato.
Aggiungi un nodo Schema Extractor per estrarre dati strutturati dalla fattura: nome fornitore, numero fattura, importo totale e data di scadenza.
Aggiungi un nodo HTTP Request per inviare tramite POST i dati estratti all'API del tuo sistema contabile.

Suggerimenti e Note

Il polling non e istantaneo. I file vengono rilevati al ciclo di polling successivo, non nel momento in cui vengono caricati. Con l'intervallo predefinito di 5 minuti, puo esserci un ritardo fino a 5 minuti tra il caricamento e l'esecuzione del workflow.
Un'esecuzione per file. Se tre nuovi file appaiono tra due polling, Flusso avvia tre esecuzioni separate del workflow — una per ogni file.
Le cartelle condivise sono supportate. Puoi monitorare cartelle condivise con il tuo account Google purche il tuo account abbia accesso in lettura.
Riconnetti se l'accesso Google scade. I token OAuth di Google possono scadere o essere revocati. Se il trigger smette di attivarsi, vai su Impostazioni → Integrazioni e riconnetti il tuo account.
L'intervallo minimo di polling e 1 minuto. Impostare un intervallo piu breve potrebbe causare il superamento dei limiti di frequenza dell'API Google Drive.

Nodi Correlati

Dropbox Watch — il trigger equivalente per le cartelle Dropbox.
Local File Watch — monitora una directory sul filesystem del server.
HTTP Request — chiama API esterne dopo aver elaborato un file.