# tGSCopy
Copies or moves objects within a bucket or between buckets in Google Cloud Storage.
tGSCopy streamlines processes by automating the copy tasks..
## tGSCopy Standard properties
These properties are used to configure tGSCopy running in the Standard Job framework.
The Standard tGSCopy component belongs to the Big Data and the Cloud families.
The component in this framework is available in all Talend products.
## Basic settings
| Properties | Description |
| --- | --- |
| 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. |
| Credential type | Select the mode to be used to authenticate to your project.
Service account: authenticate using a Google account that is associated with your Google Cloud Platform project. When selecting this mode, the access key must be provided in the Service account key field.
Workload Identity Federation: authenticate using an external identity provider, such as AWS, Azure, or OIDC, without needing a service account key. When selecting this mode, the identity federation configuration must be provided in the Client library configuration file field.
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 token must be provided in the OAuth Access Token field.
To know more about the Google Cloud authentication process, read [the Google Cloud documentation](https://cloud.google.com/docs/authentication/). |
| Service account key | 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. |
| OAuth Access Token | Enter an access token.
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.
This property is only available when you authenticate using OAuth Access Token. |
| Source bucket name | Specify the name of the bucket from which you want to copy or move objects. |
| Project ID | When the credential type is set to OAuth Access Token, specify the project ID from which you want to copy or move objects. |
| Source object key | Specify the key of the object to be copied. |
| Source is folder | Select this check box if the source object is a folder. |
| Target bucket name | Specify the name of the bucket to which you want to copy or move objects. |
| Target folder | Specify the target folder to which the objects will be copied or moved. |
| Action | Select the action that you want to perform on objects from the list.
Copy: copies objects from the source bucket or folder to the target bucket or folder.
Move: moves objects from the source bucket or folder to the target bucket or folder.
|
| Rename | Select this check box and in the New name field enter a new name for the object to be copied or moved.
The Rename check box will not be available if you select the Source is folder check box. |
| Die on error | This check box is cleared by default, meaning to skip the row on error and to complete the process for error-free rows. |
## Advanced settings
| Properties | Description |
| --- | --- |
| Use a custom endpoint | Select this check box to use a private endpoint rather than the default one.
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](https://cloud.google.com/vpc/docs/configure-private-service-connect-apis) from Google documentation.
This property is only available when you authenticate using Service account and Application Default Credentials. |
| Use source path | Select this check box to add paths while copying or moving items in the same bucket or several ones.
When you select the Rename check box from the Basic settings view, the Use source path option does not work. |
| 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
| Variables | Description |
| --- | --- |
| Global Variables | SOURCE\_BUCKET: the source bucket name. This is an After variable and it returns a string.
SOURCE\_OBJECTKEY: the key of a source object. This is an After variable and it returns a string.
DESTINATION\_BUCKETNAME: the destination bucket name. This is an After variable and it returns a string.
DESTINATION\_FOLDER: the destination folder. This is an After variable and it returns a string.
ERROR\_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error checkbox is cleared, if the component has this checkbox.
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](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/contexts-and-variables). |
## Usage
| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component can be used as a standalone component. |
**Related concepts**
* [Managing files with Google Cloud Storage](https://help.qlik.com/talend/en-US/components/8.0/gs/tgscopy-tgslist-tlogrow-managing-files-with-google-cloud-storage-standard-component-the)