Google Translate

Google Translate provides machine translation using Google Cloud Translation API.

Installation

Add the Google Translate dependency to your build:

Requirements

Requires Brightspot 5.0 or later.

Maven

<dependency>
    <groupId>com.brightspot.translation</groupId>
    <artifactId>google</artifactId>
    <version>__HIDDEN__</version>
</dependency>

Gradle

implementation 'com.brightspot.translation:google:__HIDDEN__'

Gradle (Kotlin DSL)

implementation("com.brightspot.translation:google:__HIDDEN__")

Prerequisites

Before configuring Google Translate in Brightspot:

• Google Cloud Account — You need a Google Cloud account with the Translation API enabled
• API Key — Create an API key in your Google Developer Console

For detailed instructions, see Google's documentation:

• Cloud Translation documentation
• Creating an API key
• Cloud Translation pricing

Configuration

To configure Google Translate:

1. Click > Admin > Sites & Settings > Sites > Global.
2. From the Integrations tab, expand the Google cluster.
3. In the Google Server API Key field, enter your API key.
4. Click Save.

Note

The other fields in the Google cluster are for other Google integrations and are not required for translation.

Advanced: Custom models with Vertex AI

For organizations requiring specialized translations, Brightspot supports Google's Vertex AI with custom translation models. This is useful when:

• You have domain-specific terminology (legal, medical, technical)
• You've trained a custom AutoML Translation model
• You need more control over translation quality

Prerequisites for Vertex AI

• Google Cloud Project with Vertex AI API enabled
• Service Account with appropriate permissions
• Custom Model (optional) trained in AutoML Translation

Configuration

To configure Google Translate Advanced:

1. Click > Admin > Sites & Settings > Sites > Global.

2. Under the CMS tab, expand the Translation cluster.

3. Select Google Translate Advanced as the service type.

4. Configure the following fields:

   Field	Description
   Display Name	Optional name for this configuration
   Google Cloud Project ID	Your Google Cloud project identifier
   Service Account Credentials	JSON credentials for your service account
   Custom Model Path	(Optional) Path to your custom AutoML model

5. Click Save.

warning

Service account credentials contain sensitive data. Ensure only administrators have access to this configuration.

When to use advanced vs. standard

Feature	Standard (API Key)	Advanced (Vertex AI)
Setup complexity	Simple	More complex
Custom models	No	Yes
Domain-specific terminology	Limited	Excellent
Cost	Per-character pricing	Higher, model-dependent
Best for	General content	Specialized content

Completing setup

After configuring Google Translate, complete the general translation configuration to:

• Set available locales
• Configure completion actions
• Enable translation for specific content types

See Also

• Configuration — General translation settings
• Translating Content — How to send content for translation
• Google Cloud Translation Pricing