Get Folders
Description
Retrieves folders from a Google Drive folder and returns their Folder References and the number of folders returned.
The activity can optionally search subfolders recursively.
Common settings
Use Process Data to bind supported inputs to workflow values or upstream outputs. See Common Activity Features for shared execution, error-handling, and output-persistence settings. Availability depends on the activity.
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 whose subfolders 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 folders are retrieved only from the specified folder or from all nested subfolders.
| Value | Behavior |
|---|---|
| False | Retrieves folders only from the specified folder. |
| True | Retrieves folders from the specified folder and all subfolders recursively. |
Default value: False
Execution settings
Configure Wait All Incoming when execution paths converge, and On Error for failure handling. Select Inherit where available to use the workflow-level error policy.
Output
Folders
A collection of Folder References. Bind the collection through Process Data and pass individual references to activities that accept folder inputs.
Each folder includes metadata such as:
- Folder ID
- Folder Name
- MIME Type
- Parent Folder
- Created Time
- Modified Time
- Web View Link
Folder Count
Number of the folder references returned by the activity.
Folder Reference
Each Folder Reference represents a returned folder. Folder References are a platform-wide IB-X folder abstraction that can be passed to other activities that accept folder inputs.
| Property | Description |
|---|---|
| Name | Name of the folder. |
| Size | May be empty for folders. |
| Folder ID | Unique identifier of the folder in Google Drive. |
| Parent Folder | Parent folder containing this folder. |
| Created Time | When the folder was created. |
| Modified Time | When the folder was last modified. |
| Web View Link | Link to view the folder in Google Drive. |
Remarks
- The authenticated Google account must have access to the specified folder.
- Only folders 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.
Example: Reuse a folder
Choose the parent folder and set Recursive for the required depth. Check Folder Count, then iterate over Folders. Bind the whole current item to a compatible folder-reference input. To select a Google Drive folder by identifier in another activity, use its exposed folder identifier rather than serializing the entire metadata object as text.