The Google Drive List Items action is used to list files and folders in Google Drive. This action allows you to retrieve items from a specific folder, paginate them, and display them within the application. It is particularly preferred in file management, document selection, and reporting scenarios.
Technical Specifications
Listing Process: Retrieves files and folders via the specified folderId or driveId.
Parameter Compatibility:
settings (Object – required): Configuration information required for Google Drive integration.
folderId (String – optional): Target folder ID. If specified, only items in this folder will be listed.
driveId (String – optional): A specific shared Drive ID.
pageSize (Int32 – optional): Determines how many items to list.
Result: Returns multiple responses (Many) → Information about files and folders.
Value Binding: All parameters can be entered as fixed values or dynamically bound via the Symbol Picker.
Web & Mobile Support: Can be used in both web and mobile applications.
Google Drive List Items Action Application Steps
1. Defining the Action in UI Design
Open your project on the Kuika platform.
UI Design module, select the screen where you want to list files.
Add a button (e.g., “List Files”).
Select the button and add the + ADD ACTION → Google →Google Drive List Items action.
2. Configuring Parameters
settings (required): Select the defined settings for Google Drive integration.
folderId (optional): Enter the folder ID here if only items in a specific folder are to be listed.
driveId (optional): Can be used to list from shared drives.
pageSize (optional): E.g., 10 → Retrieves the first 10 items.
Usage Scenario: Listing Files in the “Reports” Folder
In a business application, the user wants to see the files in the ‘Reports’ folder.
Steps:
Add a “List Files” button.
In the Google Drive List Items action, enter the ID of the “Reports” folder in the folderId parameter.
Display the returned results in a Table element.
Google Drive List Items Advanced Customizations
Pagination: The list size can be controlled with the pageSize parameter; an infinite scroll scenario can be implemented.
Filtering: The returned results can be filtered by name, date, or file type.
Chained Usage: The fileId value of the file selected from the list can be passed to the Google Drive Get File Content action.
Technical Risks and Controls
If folderId is entered incorrectly, no results will be returned.
driveId should only be used for shared Drive IDs.
If the pageSize value is set too large, it may cause performance issues.