Skip to main content
The Google Storage connector uploads to and downloads from the Google Storage cloud storage service.

​
Key Capabilities

  • Google Cloud Storage integration with OAuth authentication and automatic token refresh
  • Bucket-based file organization with bidirectional file transfers
  • Glob pattern filtering with optional file deletion after download and overwrite protection
  • Optional caching to ensure only new or updated files are downloaded

​
Overview

Each Google Storage connector connects to a specific Google Storage account. Within the remote storage, you set a single bucket as the upload and/or download target. You can specify upload and download paths in the bucket, and apply filters to only send or receive specified file names and/or file extensions. Files that reach the Google Storage connector in the flow are uploaded to the upload target folder, and files found in the download target folder are downloaded and entered into the flow. Account authentication uses OAuth, and you must acquire OAuth credentials before connecting with the Google Storage connector. Once authentication is successfully completed with Google, the Google Storage connector handles refreshing the OAuth tokens to ensure that authentication persists over time.

​
Connector Configuration

This section contains all of the configurable connector properties.

​
Settings Tab

​
Authorization

Settings related to authorizing access to the remote storage.
Google might require an OAuth callback/redirect URL when generating OAuth credentials. The callback/redirect URL is the same as the address and port where the application is hosted, plus the following resource path: src/oauthCallback.rst. For example, if is hosted on ‘mydomain.com’ on port 8001, specify the following URL as the callback/redirect URL: http://mydomain.com:8001/src/oauthCallback.rst.

​
Host Configuration

Settings related to the target storage host.

​
Send

Settings related to uploading to the remote storage.

​
Receive

Settings related to downloading from the remote storage.

​
Caching

Settings related to caching and comparing files between multiple downloads.
When you enable caching, the file names are case-insensitive. For example, the connector cannot distinguish between TEST.TXT and test.txt.

​
Advanced Tab

​
Advanced Settings

Settings not included in the previous categories.

​
Proxy Settings

​
Message

​
Logging

​
Miscellaneous

​
Automation Tab

​
Automation Settings

Settings related to the automatic processing of files by the connector.

​
Performance

​
Alerts Tab

​
SLAs Tab

​
Establishing a Connection

OAuth credentials are required to establish a connection with the Google Storage connector. Acquire the OAuth credentials from Google via the Google Console, then specify them in the following connector fields on the Settings tab:
  • OAuth Client ID
  • OAuth Client Secret
Google might require an OAuth callback/redirect URL when generating OAuth credentials. The callback/redirect URL is the same as the address and port where the application is hosted, plus the following resource path: src/oauthCallback.rst. For example, if is hosted on ‘mydomain.com’ on port 8001, specify the following URL as the callback/redirect URL: http://mydomain.com:8001/src/oauthCallback.rst. Once authentication is successfully completed with Google, the Google Storage connector handles refreshing the OAuth tokens to ensure that authentication persists over time.

​
Uploading and Downloading

​
Upload

To upload files, set the Bucket Name field in the Host Configuration portion of the Settings page to the target bucket, then set the Remote Folder field in the Send portion of the Settings page to the folder where files should be uploaded. Each Google Storage connector uploads to a single folder location. Use the Overwrite remote files option to indicate whether files that already exist in the remote folder should be overwritten or skipped. After configuration is complete, files placed in the connector Transactions tab are uploaded to the remote storage. If Send Automation is enabled, the upload happens automatically; otherwise, you can send individual files from the Transactions tab.

​
Download

To download files, set the Remote Folder field in the Receive portion of the Settings page to the folder where files should be downloaded. Use a comma-delimited list to specify multiple folders. You can set the Receive Filter field on the Advanced tab to a glob filter to specify which files should be downloaded from the remote storage (for example, *.txt). You can use negative patterns to indicate files that should not be downloaded (for example, -*.tmp). Use a comma-separated list to specify multiple filters. Use Delete to specify whether successfully downloaded files should be removed from the remote storage. After configuration is complete, files are downloaded according to the Receive Automation settings, or you can manually click the Receive button on the Transactions tab.

​
Macros

​
Examples