tGSList Standard properties

Use an existing connection

Select this check box and in the Component List click the relevant connection component to reuse the connection details you already defined.

• Service account: authenticate using a Google account that is associated with your Google Cloud Platform project. When selecting this mode, the parameter to be defined is Service account key.
• Application Default Credentials: authenticate using the Application Default Credentials. When selecting this mode, no additional parameters need to be defined as credentials are automatically found based on the application environment.
• OAuth Access Token: authenticate using an OAuth access token. When selecting this mode, the parameter to be defined is OAuth Access Token.

To know more about the Google Cloud authentication process, read the Google Cloud documentation.

Click the [...] button next to the service account key field to browse for the JSON file that contains your service account key.

This property is only available when you authenticate using Service account.

The lifetime of the token is one hour. The component does not perform the token refresh operation but will fetch the new access token to operate beyond the one-hour limit.

Key prefix

Specify the key prefix so that only the objects whose keys begin with the specified string will be listed.

Delimiter

Specify the delimiter in order to list only those objects with key names up to the delimiter.

Specify project ID

When the credential type is set to OAuth Access Token, select this check box and in the Project ID field enter the project ID from which you want to retrieve a list of objects.

List objects in bucket list

Select this check box and complete the Bucket table to retrieve objects in the specified buckets.

• Bucket name: type in the name of the bucket from which you want to retrieve objects.

• Key prefix: type in the prefix to list only objects whose keys begin with the specified string in the specified bucket.

• Delimiter: type in the delimiter to list only those objects with key names up to the delimiter.

If you select the List objects in bucket list check box, the Key prefix and Delimiter fields as well as the Specify project ID check box will not be available.

When selected, enter the URL in the Google Storage Private API URL property, by respecting the following format: "https://storage.goggleapis.com".

For more information, see Access Google APIs through endpoints from Google documentation.

This property is only available when you authenticate using Service account and Application Default Credentials.

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at the Job level as well as at each component level.

Global Variables

CURRENT_BUCKET: the current bucket name. This is a Flow variable and it returns a string.

CURRENT_KEY: the current key. This is a Flow variable and it returns a string.

NB_LINE: the number of rows read by an input component or transferred to an output component. This is an After variable and it returns an integer.

A Flow variable functions during the execution of a component while an After variable functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from it.

For more information about variables, see Using contexts and variables.

Usage rule

The tGSList component can be used as a standalone component or as a start component of a process.