<aside>

Description

The Custom Google Translate Engine integrates with the Google Cloud Translation API using OAuth 2.0 authentication. This engine provides access to Google's extensive language coverage through your own Google Cloud project.

</aside>

Prerequisites

• A Google account with access to https://console.cloud.google.com
• A Google Cloud project (create one if you don't have it)

Step 1 — Enable Cloud Translation API

1. Go to: https://console.cloud.google.com/apis/library/translate.googleapis.com
2. Select your project from the top dropdown
3. Click Enable

Step 2 — Configure OAuth Consent Screen

1. Go to: https://console.cloud.google.com/apis/credentials/consent
2. Select External as User Type → click Create
3. Fill in required fields:
   • App name: anything (e.g. "SimpleT")
   • User support email: your email
   • Developer contact email: your email
4. Click Save and Continue
5. On the Scopes step → click Add or Remove Scopes → search for and add: https://www.googleapis.com/auth/cloud-translation
6. Click Update → Save and Continue through remaining steps
7. Publishing status: set to In production (or leave as Testing if only you will use it)

Step 3 — Create OAuth 2.0 Credentials

1. Go to: https://console.cloud.google.com/apis/credentials
2. Click + CREATE CREDENTIALS → OAuth client ID
3. Application type: Web application
4. Name: anything (e.g. "SimpleT Google Translate")
5. Under Authorized redirect URIs → click + Add URI → enter:
   • For local development: http://localhost:8083/google-callback
   • For production (add both): https://domain.com/google-callback
6. Click Create
7. A popup shows your credentials — copy and save both:
   • Client ID (ends in .apps.googleusercontent.com)
   • Client Secret

Step 4 — Create Google Translate Engine in SimpleT

1. Go to Translation Engines → click New Engine
2. Fill in the fields:

1. Click Save

Step 5 — Test Translation (Authentication is Automatic)

1. Open the engine → click Test Translation
2. First time only: A Google sign-in popup will appear
   • Sign in with your Google account
   • Grant the requested permissions
   • Popup closes automatically
3. Translation runs immediately after sign-in
4. All future tests: No popup — the system silently refreshes the token in the background

Notes

• Tokens are stored securely in the database — you only sign in once
• If Google revokes access (e.g. you remove the app from your Google account permissions), the popup will appear again automatically on the next test
• For production deployment, add your production domain's callback URL to the Authorized redirect URIs list in Google Cloud Console

<aside>

Quick View

End User Documentation

• SimpleTranslate
• SimpleT AI
• Organization </aside>