The most complete and secure Google Cloud Storage integration for OutSystems.

Manage buckets and objects in Google Cloud Storage directly from your OutSystems applications. Built on the official Google Cloud .NET SDK, this connector authenticates with service-account credentials — no JSON key files on the server — and covers the full object and bucket lifecycle, including signed URLs and metadata retrieval.

Features

• Full Object Lifecycle: Upload, download, list, delete, and check the existence of files.

• Object Metadata: Inspect a file's size, hashes, versioning, and timestamps without downloading it.

• Bucket Management: Create, list, and delete buckets programmatically.

• Secure Authentication: Credentials are passed as parameters for per-environment configuration — no key files stored on the server.

• Signed URLs: Generate temporary, secure access links for private objects (V4 signing).

• Official SDK: Built on Google.Cloud.Storage.V1 for reliable, low-latency operations.

Action Reference

Object Actions

• Object_Upload — Uploads binary data with a defined content type for correct browser rendering.

• Object_Download — Retrieves an object's content and content type.

• Object_List — Lists objects in a bucket, with optional prefix filtering for folder-like navigation.

• Object_Delete — Permanently deletes an object from a bucket.

• Object_Exists — Lightweight existence check using metadata only, with no content transfer.

• Object_GetMetadata — Retrieves an object's full metadata (size, content type, hashes, generation, storage class, timestamps) without downloading its content. New in v1.1.0.

• Object_GetSignedUrl — Generates a temporary GET URL for direct-to-browser downloads.

Bucket Actions

• Bucket_List — Lists all buckets in the project.

• Bucket_Create — Creates a bucket in a chosen location (e.g., US, EU, ASIA).

• Bucket_Delete — Deletes an empty bucket.

Structures

• GCS_Object — A file entry in a list result: Name, Size, ContentType, Updated.

• GCS_Bucket — A bucket: Name, Location, StorageClass, Created.

• GCS_ObjectMetadata — Full metadata for a single object (returned by Object_GetMetadata): Name, Bucket, Size, ContentType, ContentEncoding, ContentDisposition, CacheControl, MD5Hash, Crc32c, ETag, Generation, Metageneration, StorageClass, MediaLink, TimeCreated, Updated. New in v1.1.0.

Prerequisites

1. An active Google Cloud project.

2. A service account with the roles your operations require: Storage Object Admin (objects), Storage Admin (buckets), and Service Account Token Creator (only if signing URLs via IAM rather than the provided private key).

3. A downloaded JSON key for that service account.

Authentication Setup

Instead of storing a JSON key file on the server, map these values from your service account JSON to OutSystems Site Properties and pass them as inputs to the actions:

• project_id -> ProjectId

• client_email -> ClientEmail

• private_key -> PrivateKey (the full string, including the -----BEGIN PRIVATE KEY----- header)

Security tip: Always keep the PrivateKey in a Site Property or an encrypted database table — never hardcode it.

Best Practices

• Large files: Use Object_GetSignedUrl so users transfer directly to and from Google, easing server RAM and bandwidth.

• Pre-flight checks: Call Object_GetMetadata before a download to read size and content type up front — enforce limits or set MIME handling without transferring the file.

• Per-environment config: Bind the credential inputs to Site Properties so Dev, QA, and Prod each target their own project and bucket.