Skip to content
Nappai Documentation

Google Drive File Manager

Google Drive File Manager lets you upload, copy, retrieve, update, delete, move, and share files in your Google Drive directly from the Nappai dashboard. It connects to Google Drive through a secure credential and gives you a simple interface to work with files and folders without writing code.

How it Works

When you add this component to a workflow, Nappai uses the Google Drive API to perform the chosen operation. The component sends the necessary data (file content, file ID, folder ID, etc.) to Google Drive, receives the response, and passes the result back to the next step in the workflow. If you enable Mapping Mode, the component can process many records at once, making batch uploads or downloads straightforward.

Operations

This component offers several operations that you can select based on what you need to do. You can only use one operation at a time:

  • Upload: Add a new file to a specified folder in Google Drive.
  • Copy: Duplicate an existing file to another location.
  • Get: Retrieve a file’s metadata or content.
  • Update: Change a file’s name or other properties.
  • Delete: Remove a file from Google Drive.
  • Move: Relocate a file to a different folder.
  • Share: Grant another user access to a file.

To use the component, first select the operation you need in the “Operation” field.

Inputs

Mapping Mode

This component has a special mode called “Mapping Mode”. When you enable this mode using the toggle switch, an additional input called “Mapping Data” is activated, and each input field offers you three different ways to provide data:

  • Fixed: You type the value directly into the field.
  • Mapped: You connect the output of another component to use its result as the value.
  • Javascript: You write Javascript code to dynamically calculate the value.

This flexibility allows you to create more dynamic and connected workflows.

Input Fields

  • File Content: Content that will be used for the file. If the file is a Drive mimeType, copy operation or move operation must be used.

    • Visible in: Upload

  • Select file: Select the file to use.

    • Visible in: Copy, Get, Update, Delete, Move, Share

  • Select folder: If not selected, it will be the root folder.

    • Visible in: Upload, Copy, Get, Update, Move

  • Operation: Operation to perform

    • Visible in: Upload, Copy, Get, Update, Delete, Move, Share

  • Download Base64 Content: Include the file content converted to base64 when using file id in the get.

    • Visible in: Get

  • Email: Email of user that will shared the file.

    • Visible in: Share

  • File Id: Introduce the Id of the file.

    • Visible in: Copy, Get, Update, Delete, Move, Share

  • File Type: Select the file type that will used as filter. If any is selected, all files will be returned. If file its selected or File Id its provided, this field will be ignored.

    • Visible in: Get

  • Filename: Name that will be used for the file, if not provided it will used filename in Binary Component. In Get Operation, this field will be used as a filter.

    • Visible in: Upload, Get

  • Folder Id: Introduce the Id of the folder.

    • Visible in: Upload, Copy, Get, Update, Move

  • Mapping Mode: Enable mapping mode to process multiple data records in batch

    • Visible in: Upload, Copy, Get, Update, Delete, Move, Share

  • Mode of Input: Mode to use. If All Files in Drive its selected, all files will be used until the limit of 100 files is reached. If By Id its selected, the inputs will be Id If By Filename its selected, the inputs will be Filename If By Selection its selected, the inputs will be a selection. If By Url its selected, the inputs will be Url

    • Visible in: Upload, Copy, Get, Update, Delete, Move, Share

  • New Name: New Name to update the existing file.

    • Visible in: Update

  • Process File Content: Include the file content processed in text when using file id in the get

    • Visible in: Get

  • Role: Role that will be asigned to the user.

    • Visible in: Upload, Share

  • Selection Mode: Mode to use to select the files. If Folder its selected, all the files in the folder will be returned. If File its selected, the file will be selected from the files.

    • Visible in: Get

  • Send Notification: Send Notification to user

    • Visible in: Upload, Share

  • Type: Type of permission that will be asigned to the user.

    • Visible in: Upload, Share

  • Tool Name: The name of the tool that will be used when this component is connected as a tool. This name will be displayed to the agent when it selects tools to use.

    • Visible in: Upload, Copy, Get, Update, Delete, Move, Share

  • Tool Description: A detailed description of what this tool does. This description will help the agent understand when and how to use this tool effectively.

    • Visible in: Upload, Copy, Get, Update, Delete, Move, Share

  • Tools arguments metadata: Defines the arguments metadata for the tools.

    • Visible in: Upload, Copy, Get, Update, Delete, Move, Share

Outputs

  • Data: The result of the performed action (e.g., file metadata, content, or confirmation of deletion). This output can be used by subsequent components.
  • Tool: A toolkit representation of the component that can be passed to an AI agent for automated decision‑making.

Usage Example

Uploading a file

  1. Drag the component onto the canvas and set Operation to Upload.
  2. In File Content, paste or upload the file data.
  3. (Optional) Set Folder Id to place the file in a specific folder; leave blank to use the root.
  4. Set Filename if you want a custom name; otherwise the original name is used.
  5. Click Run. The component returns the file’s metadata in the Data output.

Retrieving a file

  1. Set Operation to Get.
  2. Provide the File Id of the file you want to retrieve.
  3. If you want the raw content, check Download Base64 Content or Process File Content.
  4. Run the component. The file’s content or metadata appears in the Data output.
  • Google Drive Folder Manager – Create, list, or delete folders in Google Drive.
  • Google Drive File Search – Find files by name, type, or other criteria.

Tips and Best Practices

  • Use Mapping Mode when you need to process many files at once; it saves time and reduces API calls.
  • Always provide a File Id for Get, Update, Delete, Move, and Share to avoid scanning the entire drive.
  • When sharing files, set the Role and Type carefully to give the correct level of access.
  • Enable Send Notification only when you want the recipient to receive an email alert.
  • Keep your Google Drive credentials secure and grant only the permissions needed for your workflows.

Security Considerations

  • Store the Google Drive credential in Nappai’s credential manager; never expose client secrets in the workflow.
  • Use the least‑privilege principle: grant the credential only the scopes required for the operations you need (e.g., drive.file for file‑level access).
  • Monitor API usage to detect any unexpected activity.
  • When sharing files, double‑check the email address and permission type to avoid accidental data exposure.