Google Drive download file

Note: This is an external action and may execute on servers running outside your data center Centralized locations used to house servers used by Nintex for remote storage, processing, or distribution of data. Nintex has a number of regional data centers available for Nintex for Office 365. For information about Nintex data centers and where your data center is located, contact your Nintex account or territory manager. region. Before implementing, consider performance and regional concerns where digital boundaries are an issue. For more information, see In-tenant and external actions.

Downloads a file from Google Drive identified by either the file ID or the file name. The file ID can be retrieved from the following actions: Google Drive query files and Google Drive upload file.

Note: If the service encounters multiple folders with the same name, it will only access the most recently modified folder. Likewise, if the service encounters multiple files with the same name, it will only download the most recently modified file.

Action settings

Do one of the following to open the Action configuration window:

  • Double-click the action.
  • Click on the action and then click Configure.

See Action configuration window for more information.

Field Description

Identify file by

Select one of the following options.

  • File Name And Source Folder: Identifies file by its name and (optionally) source folder.

  • File ID: Identifies file by its ID.

    To find a Google Drive file ID, retrieve a link using Get Link and then locate the characters after "id=" as indicated in bold in the following example: 
    https://drive.google.com/open?id=FILE_ID

File ID or name

Specify the ID or the name of the file to download, according to the option selected for Identify file by. If specifying a file name, include the extension when applicable.

Source folder

Specify the folder containing the file to be downloaded.

Example: Crestan\Depts

Note: If multiple folders of the same name exist, only the most recently modified folder is accessed.

Authorizing user

Specify an email address to receive the authorization request for the action. External email addresses can be used.

  1. When the action runs, an email with the below content is sent to the email address selected for the Authorizing user.

    2. From: notification@nintexlive.com

    Subject: Contains phrases "Nintex Live" and "Request authorization".

    Contents: Contains links to authorize or deny the operation.

  2. When the link to provide authorization is clicked the user is prompted to do the following:
    1. Log in to the external service.
    2. Allow Nintex Live to access the external service.
    3. Option to stop receiving future authorization requests for the service.

If the authorizationis not provided for one of the following reasons, the workflow is suspended.

  • The authorizing user denies the authorization request by:
    • Clicking the deny link in the email received.
    • Not allowing Nintex live to access the external service.

    The workflow is suspended with the error "The service request has been denied".

  • Authorization is not provided within 7 days after the authorization request is sent.
    • The authorizing user never clicks the authorize link in the email message.
    • The authorizing user initiates the process by clicking the link but does not complete all steps. For example, the authorizing user logs in to the external service but does not complete the step to allow Nintex Live to access the external service.

    • The workflow is suspended with the error "The service request has expired".
Convert

When a conversion format is selected, converts the file specified for download from the source Google Drive format.

Note: Conversion is required when downloading files of Google Drive formats, such as Google Docs or Google Sheets. Files of Google Drive formats that are not converted are corrupted on download and thus unusable.

Select one of the following options. Source formats supported for conversion by the Google Drive API are indicated in parentheses.*

  • No conversion: Downloads the file as-is.

    Use this option when the file is not in a Google Drive format.

  • CSV: Converts the file to CSV format before download. (Google Sheets)
  • DOCX: Converts the file to DOCX format before download. (Google Docs)
  • HTML: Converts the file to HTML format before download. (Google Docs)
  • JPEG: Converts the file to JPEG format before download. (Google Drawings)
  • PDF: Converts the file to PDF format before download. (Google Docs, Google Drawings, Google Sheets, Google Slides )
  • PNG: Converts the file to PNG format before download. (Google Drawings)
  • PPTX: Converts the file to PPTX format before download. (Google Slides)
  • RTF: Converts the file to RTF format before download. (Google Docs)
  • SVG: Converts the file to SVG format before download. (Google Drawings)
  • TXT: Converts the file to TXT format before download. (Google Docs, Google Slides)
  • XLSX: Converts the file to XLSX format before download. (Google Sheets)

*As of September 2015

If the Google Drive API does not support conversion from the source format to the selected destination format, then an error message is logged to workflow history when the action is executed.

Save file as

Location for the newly downloaded file. Select one of the following options.

For more information about how to use Lookups in configuration fields, see Lookups in action configuration fields.