This document outlines the functionality and characteristics of the Google Drive Folder Reader node, which enables automated content extraction from multiple files in a Google Drive folder.

​
Node Inputs

​
Folder Selection (Choose one method)

  • Select Folder: Choose a folder directly from Google Drive
  • Use Link: Option to use a direct Google Drive folder URL

​
Configuration Options

  • Read All Subfolders: When enabled, the node will read files from all subfolders within the selected folder

    • Reads through all nested levels (subfolders of subfolders)

    • Great for processing entire folder hierarchies in one operation

    • Toggle this option under “More options”

    • Default: No (only reads files from the selected folder)

    Note: The subfolder reading option is not available when using this node as a trigger (as of now)

​
Node Output

  • Files: List of file objects from the folder. Each file object can be:
    • Passed directly to file operation nodes (PDF Reader, File Reader, etc.)
    • Sent to communication nodes as attachments (Slack, Gmail, etc.)
    • Used with the AI Analyze Image and Analyze Video nodes

Important Note: For Google Docs and Google Sheets files, the output is not the file object itself but rather the file link. This link can be connected directly to nodes like Google Docs Reader or Google Sheets Reader for content extraction.

Note: While the output shows file names for easy reference, for non-Google files each item is actually a complete file object that can be processed by other nodes.

​
Working with File Outputs

The node’s output can be connected directly to various other nodes:

​
File Operations

  • PDF Reader: Process PDF files directly
  • File Reader: Extract content from text files
  • Google Docs Reader: Process Google Docs file links
  • Google Sheets Reader: Process Google Sheets file links

​
Communication

  • Slack Message Sender: Share files in Slack channels
  • Gmail Sender: Send files as email attachments
  • Discord Message Sender: Share files in Discord

​
AI Processing

Note: For text-based AI processing, files must first be processed by appropriate reader nodes:

Only Analyze Image and Analyze Video nodes can process the relevant media file objects directly.

​
Node Functionality

The Google Drive Folder Reader node provides automated batch access to contents of all files within a specified folder.

Key features include:

  • Support for multiple file formats
  • Recursive subfolder reading capability
  • Loop mode to process multiple folders
  • Secure authentication with Gumloop

​
Trigger Functionality

This node can also function as a trigger to start your flow when your drive folder receives a new file upload. Learn more about triggers here: https://docs.gumloop.com/core-concepts/triggers

Important: When used as a trigger, the subfolder reading option is not available. The trigger only monitors the top-level folder for new files.

​
Example Workflows

​
1. Document Analysis Pipeline

Google Drive Folder Reader 
→ File Reader/PDF Reader/Google Docs Reader 
→ Ask AI 
→ Notion Page Writer

Purpose: Analyze and summarize document contents

Note: File content must be extracted before AI processing

​
2. File Distribution

Google Drive Folder Reader 
→ Slack Message Sender

Purpose: Share new documents with team members

​
3. Data Analysis

Google Drive Folder Reader 
→ File Reader/Google Sheets Reader 
→ Extract Data 
→ Airtable Writer

Purpose: Process and store data from multiple CSV/XLSX/Google Sheets files

​
4. Recursive Document Processing

Google Drive Folder Reader (with Read All Subfolders enabled) 
→ PDF Reader 
→ Extract Data 
→ Google Sheets Writer

Purpose: Process all PDFs across multiple project folders and subfolders

​
When to Use

The Google Drive Folder Reader node is particularly valuable in scenarios requiring processing of multiple files. Common use cases include:

  • Document Analysis: Extract and analyze text from multiple student essays or research papers
  • Invoice Processing: Batch process invoices stored as PDFs to extract payment information
  • Report Compilation: Combine daily sales reports from multiple store locations into a single dataset
  • Dataset Processing: Extract and combine data from multiple CSV files containing customer feedback
  • Project Archives: Process entire project folder structures with the subfolder option enabled

Some specific examples:

  • Reading monthly financial statements to aggregate spending patterns
  • Processing student assignments to check for plagiarism
  • Extracting product information from multiple specification sheets
  • Combining daily log files for system performance analysis
  • Processing an entire document library with nested folder organization

​
Important Considerations

  1. Requires Authentication with Google - Set up in the Credentials page
  2. You must have access to the folder
  3. Large folders or files may take longer to process
  4. Reading all subfolders can significantly increase processing time for deeply nested structures
  5. For Google Docs and Google Sheets, you’ll receive file links that must be passed to appropriate reader nodes
  6. For other file formats, file objects can be passed directly to file operation nodes and communication nodes, but text-based AI nodes require content extraction first

In summary, the Google Drive Folder Reader node simplifies batch processing of files in Google Drive folders, automatically handling multiple file formats and providing organized access to file content. Its output can be seamlessly integrated with other nodes for comprehensive file processing workflows.