Skip to content

Google Drive: Download File

Plugin ID: eca_google_drive_download_file

Available since: 1.0.0

Downloads files from Google Drive with format conversion options for Google Workspace documents (PDF, DOCX, XLSX, etc.).

Fields

Authentication Type — config key: auth_type

Choose between API Client (OAuth2) or Service Account authentication.

Type: select · Required: yes · Default: api_client

Allowed values: api_client, service_account

Authentication Source — config key: auth_from

Choose whether to select authentication directly or use a token for dynamic selection.

Type: select · Required: yes · Default: direct

Allowed values: direct, token

API Client — config key: api_client_id

Search and select an API Client for OAuth2 authentication.

Type: textfield · Required: no · Default: empty string

Service Account — config key: service_account_id

Search and select a Service Account for server-to-server authentication.

Type: textfield · Required: no · Default: empty string

Client ID from Token — config key: auth_client_from_token

Token that resolves to a client ID (e.g., [user:field_google_client_id]). The token should contain just the client ID, not the auth type prefix.
This field supports tokens.

Type: textfield · Required: no · Default: empty string

File ID — config key: file_id

Google Drive file ID to download. Supports token replacement.
This field supports tokens.

Type: textfield · Required: yes · Default: empty string

Export Format — config key: export_format

Format to export Google Workspace documents (Google Sheets, Docs, Slides only). Regular uploaded files cannot be converted. Leave empty for no conversion.

Type: select · Required: no · Default: empty string

Allowed values: '', application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.openxmlformats-officedocument.presentationml.presentation, text/csv, text/html, text/plain

Save to Drupal File System — config key: save_to_drupal

Set to "1", "true", or "yes" to save the downloaded file to Drupal's file system and create a file entity.
This field supports tokens.

Type: textfield · Required: no · Default: 1

Local Directory — config key: local_directory

Directory to save the file. Use Drupal stream wrappers like "public://", "private://", or absolute paths.
This field supports tokens.

Type: textfield · Required: no · Default: public://drive-downloads

Filename Override — config key: filename_override

Optional custom filename for the downloaded file. If empty, uses original filename.
This field supports tokens.

Type: textfield · Required: no · Default: empty string

Size Limit (MB) — config key: size_limit

Maximum file size in MB. Default: 50MB. Larger files may cause timeouts.

Type: textfield · Required: no · Default: 50

Download Token Name — config key: download_token_name

Optional token name to store download information. Accessible as [token_name:content], [token_name:local_path], [token_name:file_entity_id], etc.
This field supports tokens.

Type: textfield · Required: no · Default: empty string