Task Factory Google

Task Factory users running version 2020.1.4 or older (released prior to May 27, 2020): There's an important Task Factory update. Please visit here for more details.

Google Cloud OAuth2 Connection Manager

This connection manager is used with the Google Cloud Source and Google Cloud Rest Destination. Before connecting, users must obtain a Client ID, Client Secret, a Storage Project Id, and a Redirect URL from Google's APIs & Services Credentials dashboard.

Task Factory Google Cloud OAuth2 Connection Manager

Connection Settings

Option

Description

Client Id

The Client ID is found in Google's APIs & Services - Credentials console.

Client Secret

The Client Secret is found in Google's APIs & Services - Credentials console.

Access Token

Select Get Token to open the Token Getter window.

Is Bearer Token?

Select this option if the Access Token is a bearer token.

Access Token Expiration Date

The expiration date of the access token.

Note: This settings is optional.

Security Protocol

The Security Protocol used by the API. The Default option uses the TLS version used by your .NET version by default. See the following chart for more information:

.NET Version	TLS Support Information
.NET 4.6 and above	Supports TLS 1.2 by default.
.NET 4.5	TLS 1.2 is supported, but you need to opt-in to use it. Execute the following code before making a connection to a secured resource to make TLS 1.2 the default: ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12
.NET 4.0	TLS 1.2 is not supported. If you have .NET 4.5 (or above) installed on the system, you can opt in for TLS 1.2 even if your application framework doesn’t support it. SecurityProtocolType in .NET 4.0 doesn’t have an entry for TLS1.2, so you need to use a numerical representation of this enum value: ServicePointManager.SecurityProtocol = (SecurityProtocolType)3072;
.NET 3.5 or below	TLS 1.2 is not supported, and there is no workaround. Upgrade your application to a more recent version of the framework.

Storage Project Id

The storage project Id for your connection.

Token Getter

Task Factory Google Cloud OAuth2 Token Getter

Option	Description
Client Id	This field should be auto-completed from the previous window with your Client ID.
Client Secret	This field should be auto-completed from the previous window with your Client Secret.
Scopes	Selects which permission to be used in the call: Full Control Read Write Read Only Additional Information: For more information about Scopes, see Google's Cloud Storage Authentication.
Port for response	The port on your local machine where you want to send the token request response.
Set your Redirect Uri to	Use this as your Redirect Uri in your OAuth2 App settings.
Get Access Token	Opens a browser window to login to your Google account and grant access.

Headers

Task Factory Google Cloud OAuth2 Connection Manager Headers

You can create header names and values by entering the information in their corresponding windows.

Option	Description
Add New Header	Select to add a new header name and value. Once added, you can select within the column and configure the name and the value.
Remove Header	Remove the selected header to be included in the component's output.

Refresh Token

Task Factory Google Cloud OAuth2 Connection Manager Refresh Token

Option	Description
Refresh Token	Authentication information provided to you at the application's developer site. Note: This should match the API Key from the Connection Settings window.
Token Request Url	The URL that returns a refresh token. Example: https://api.citrixonline.com/oauth/access_token
Headers	Allows you to add headers within the refresh token. Select Add New Header to add a header. Select Remove header to remove a header.
Results Returned In	Specifies how results are returned from the application (JSON, XML, or String.)
Access Token Path	The token path for the access token. Example: access_token
Refresh Token Path	The token path for the refresh token. Example: refresh_token
Use Token Store	This option creates a file on your machine that saves the access token, and refresh token in an encrypted format.
Token Store Id	Identifies the Token Store Id.
Token Store Path (Optional)	Identifies the Token Store path.

Client Certificate

Task Factory Google Cloud OAuth2 Connection Manager Client Certificate

Option	Description
Use Client Certificate	Select this option if you want to use the client certificate.
Certificate Store Location	The client store location.
Search For Certificate	Enter a certificate that you want to search for and then select Find. Note: Leave this section blank and select Find to view all certificates.
Certificate Thumbprint	The identifier thumbprint of the selected certificate.

Proxy

Task Factory Google Cloud OAuth2 Connection Manager Proxy

Option	Description
Proxy Host	When connecting to an endpoint using a proxy, you should enter the proxy URL in this field.
Proxy Port	The port number that corresponds to the URL proxy host.
Proxy User Name	The username needed to authenticate to the proxy.
Proxy Password	The password that allows you to authenticate to the proxy.

Advanced Options

Task Factory Google Cloud OAuth2 Connection Manager Advanced Options

Option	Description
Ignore Ssl Certificate Verification	Selecting this option ignores the SSL Certificate notification from the API during the connection. Note: This option applies to APIs that require you to have an SSL Certificate. Select this option if the SSL Certificate is not needed.
Follow Redirects	Selecting this option implements a 301 redirect on configured endpoints. For example, this option would automatically send your request to an HTTPS redirect once the request has reached the http version of the site.

Google Drive Oauth2 Connection Manager

Used with the Google Drive Source and Google Drive Destination. Before connecting, users must obtain a Client ID, Client Secret, and Redirect URL from Google's APIs & Services Credentials dashboard.