Connect to Google Cloud Storage

Clicking Google Cloud Storage opens the "Add a connection" dialog with the following fields.

Connection Name: A user-defined display name for this connection.

Description: A brief text description of what this connection is used for.

Bucket: The name of the Google Cloud Storage bucket you want Tellius to connect to. Enter only the bucket name (for example, "your-gcs-bucket"), not the full gs:// URI or HTTPS URL. The service account credentials you provide must have read access to this bucket, specifically the storage.objects.list and storage.objects.get permissions.

Start Date: An optional date picker that specifies the earliest date from which Tellius should pull files. Only objects created or modified on or after this date will be synced.

Account Key File Info: A dropdown that specifies how the Google Cloud service account credentials are provided. Two options are available:

• Paste JSON: Opens a text area (the JSON File field below) where you paste the full contents of the service account JSON key file directly into the form.

• Upload File: Displays a file upload area where you can drag and drop or browse to select the service account JSON key file from your local machine. The upload zone accepts up to 1 file with a maximum total size of 40.00 MB.

JSON File: This field appears when Paste JSON is selected in Account Key File Info. Paste the full contents of the Google Cloud service account JSON key file here. This is the credential file you download from the Google Cloud Console when you create a service account key (IAM & Admin > Service Accounts > Keys > Add Key > Create new key > JSON). The JSON contains the project ID, private key, client email, and other authentication details that Tellius needs to access the GCS bucket on behalf of the service account.

Scheduled Sync: Configures how frequently Tellius automatically syncs files from this GCS bucket.

• Manual - Tellius will only sync when you explicitly trigger it using the Synchronize action from the three-dot menu on the connections table.

• Schedule - Set automatic recurring syncs so that new files added to GCS are automatically pulled into Tellius without manual intervention. A second dropdown appears: Cron Schedule (UTC).

The Cron Schedule dropdown lets you define how frequently Tellius automatically syncs files from the connected source. All schedule times operate in UTC, so factor in your local timezone when choosing a schedule. The available options are:

• Hourly

• Every 6 hours

• Daily at midnight

• Daily at 2 AM

• Every 12 hours

Choose a schedule frequency that matches how often new content arrives in your source. Over-frequent syncing on a source that rarely changes adds unnecessary processing load, while under-frequent syncing on an active source means Kaiya may not have access to the latest files.

Click Continue to proceed with creating the connection, or Cancel to discard the configuration.