Skip to main content
Version: Current

Get Files

Description​

Retrieves files from a Google Drive folder and returns their File References and metadata.

The activity can optionally search subfolders recursively.

Common Capabilities​

Process Data Support​

info

This activity supports dynamic configuration using variables from the Process Data drawer.

You can bind values from Agent Data, Workflow Data, Form Data, System Data, Enterprise Variables, and Activity Outputs.

Learn more → Using Process Data

Design-Time Configuration​

Display Text​

A user-defined name for the activity, displayed on the workflow canvas to help identify its purpose.

Connection Name​

The configured Google Drive connection used to access Google Drive resources.

Parent Folder​

The folder from which files will be retrieved.

You can:

  • Select a folder using the Custom Picker Dialog.
  • Provide a folder identifier dynamically through Process Data.

Default value: My Drive

Recursive​

Determines whether files are retrieved only from the specified folder or from all nested subfolders.

ValueBehavior
FalseRetrieves files only from the specified folder.
TrueRetrieves files from the specified folder and all subfolders recursively.

Default value: False

Wait All Incoming​

Execution Control

Controls how this activity behaves when multiple incoming execution paths converge.

Determines whether the activity executes when:

  • Any incoming path completes, or
  • All relevant incoming paths complete before execution

Learn more → Execution Control

On Error​

Error Handling Strategy

Defines how the workflow behaves if this activity encounters a runtime error.

Supported strategies include:

  • Fault
  • Continue
  • Suspend
  • Retry

Learn more → Error Handling

Output​

Files​

A collection of files retrieved from the selected folder. Each item includes a File Reference and metadata. Bind the collection through Process Data, iterate over its items, and pass each File Reference to activities that accept file inputs.

Metadata​

Each file includes metadata such as:

  • File ID
  • File Name
  • MIME Type
  • Parent Folder
  • Created Time
  • Modified Time
  • Web View Link

Remarks​

  • The authenticated Google account must have access to the specified folder.
  • Only files accessible to the authenticated account are returned.
  • When Recursive is enabled, all nested folders are searched recursively.
  • Large folder structures may increase execution time when recursive search is enabled.
Help improve this page