ToolJet/docs/versioned_docs/version-3.16.0-LTS/data-sources/gcs.md

id	title
gcs	Google Cloud Storage

ToolJet can connect to GCS buckets and perform various operation on them.

Connection

To establish a connection with the Google Cloud Storage data source, you can either click on the + Add new Data source button located on the query panel or navigate to the Data Sources page through the ToolJet dashboard.

ToolJet requires the following to connect to a GCS datasource:

• JSON Private Key

You can refer to the Google Cloud Documentation to get started.

Querying GCS

1. Click on + Add button of the query manager at the bottom panel of the editor.
2. Select the GCS datasource added in previous step.
3. Select the Operation.
4. Click on the Preview button to preview the output or Click on the Run button to create and trigger the query.

:::tip Query results can be transformed using transformations. Read our transformations documentation to see how: link :::

Supported operations

• Read file
• Upload file
• List buckets
• List files in a bucket
• Signed url for download
• Signed url for upload

<img className="screenshot-full img-full" src="/img/datasource-reference/gcs/listops.png" alt="gcs list of operations" style={{marginBottom:'15px'}} />

Read File

Reads the content of a file from GCS.

Required Parameter

• Bucket
• File Name

<img className="screenshot-full img-full" src="/img/datasource-reference/gcs/read-query.png" alt="gcs read query" style={{marginBottom:'15px'}} />

Uplodad File

Uploads a file to GCS.

Required Parameter

• Bucket
• File name
• Upload data

Optional Parameter

• Content Type
• Encoding

<img className="screenshot-full img-full" src="/img/datasource-reference/gcs/upload-query.png" alt="gcs upload query" style={{marginBottom:'15px'}} />

Example:

{
    'name' : 'Shruthi Jotsna'
}

List Buckets

Retrieves a list of available buckets.

<img className="screenshot-full img-full" src="/img/datasource-reference/gcs/list-bucket-query.png" alt="gcs list query" style={{marginBottom:'15px'}} />

List Files in a Bucket

Lists files within a specific GCS bucket.

Required Parameter

• Bucket

Optional Parameter

• Prefix

<img className="screenshot-full img-full" src="/img/datasource-reference/gcs/list-files-query.png" alt="gcs list query" style={{marginBottom:'15px'}} />

Signed URL for Download

Generates a signed URL for downloading a file.

Required Parameter

• Bucket
• File Name

Optional Parameter

• Expires in

<img className="screenshot-full img-full" src="/img/datasource-reference/gcs/signed-download-query.png" alt="gcs url download query" style={{marginBottom:'15px'}} />

Signed URL for Upload

Generates a signed URL for uploading a file.

Required Parameter

• Bucket
• File name

Optional Parameter

• Expires in
• Content Type

<img className="screenshot-full img-full" src="/img/datasource-reference/gcs/signed-upload-query.png" alt="gcs url upload query" style={{marginBottom:'15px'}} />