Google Drive

Google Drive operations — list, search, upload, download, and manage files.

The node authenticates through a Google connection. No API key or service account setup is needed — connect a Google account once and pick it in the node's settings.

When to Use

Use Google Drive when:

You want to read or write files in Drive from a workflow (generated reports, exports, attachments)
You need to search Drive for files matching a query and pass them downstream
You want to give an AI Agent tool access to your Drive

Connection

Google Account — required. Pick a Google connection from the Connections page. Click Manage to add one; the picker reopens when a connection exists.

Inputs

Handle	Type	Description
`input`	any	Upstream data for `{{ input.field }}` template references in settings.

Output

Handle	Type	Description
`result`	object	Google Drive operation result

The result (accessed as {{ google_drive.* }}) shape:

Field	Type	Description
`success`	boolean	Whether the operation succeeded
`files`	array	Matching files (list/search operations)
`response`	object	Raw Google Drive API response

Settings

Each node run executes a single operation. Set Operation, then configure the fields shown for that operation.

Operation

Setting	Type	Default	Description
`operation`	enum	`list_files`	Drive action to perform: `list_files`, `search_files`, `get_file`, `create_folder`, `upload_file`, `download_file`, `delete_file`, or `move_file`.

Agent Permissions

Setting	Type	Default	Description
`allowed_operations`	multi-select	All operations	Which operations are available when this plugin is used as an AI agent tool.

Target

Shown for operations that need a file or folder:

Setting	Type	Default	Description
`file_id`	string	—	Google Drive file ID. Supports `{{ }}` bindings.
`folder_id`	string	—	Parent folder ID (root if empty). Supports `{{ }}` bindings.
`query`	string	—	Drive search query (e.g. `name contains 'report'`). Supports `{{ }}` bindings.

Content

Shown for create/upload operations:

Setting	Type	Default	Description
`file_name`	string	—	File or folder name. Supports `{{ }}` bindings.
`data`	code editor	—	File content for upload operations. Supports `{{ }}` bindings.

Example

Append a generated report to Drive on a webhook:

Webhook Trigger → Google Drive (upload_file)

Google Drive settings:

Operation: upload_file
Folder ID: 1AbC... (destination folder)
File Name: report-{{ webhook.body.id }}.txt
Data: {{ webhook.body.content }}