Google AI on Google Cloud offers pre-trained machine learning services for images and audio, such as Cloud Vision, Speech-to-Text and Text-to-Speech. The UnifyApps Google AI connector uses the Cloud Vision, Cloud Speech-to-Text and Cloud Text-to-Speech APIs to read text in images, transcribe audio and turn text into speech from workflows.
This guide covers every authentication type available on the connection form, and the actions supported, along with the Google Cloud API each one needs.
Authentication
Before you begin, you should have the following information:
Connection name: a descriptive name such as MyAppGoogleAIIntegration, so the connection is easy to identify later.
Authentication type: Google AI connects only with a Google Cloud service account, so the form has no authentication type to select:
Service Account (JWT)
The connection always requests the https://www.googleapis.com/auth/cloud-platform scope. There is no Scopes field on the form.
1. Service Account (JWT)
Use this to connect with a Google Cloud service account that acts on behalf of a user in your Google Workspace domain through domain-wide delegation. No user has to sign in.
Step 1: Create a service account in Google Cloud
In the Google Cloud Console, select or create a project, and make sure billing is enabled for it.
Under APIs & Services → Library, enable the APIs for the actions you plan to use: Cloud Vision API, Cloud Speech-to-Text API and Cloud Text-to-Speech API.
Go to IAM & Admin → Service Accounts and click Create service account. Enter a name and click Done.
Open the service account and copy its Email. Click Show advanced settings and, under Domain-wide delegation, copy the Client ID used in the next step.
Go to the Keys tab → Add key → Create new key, choose JSON and click Create. The downloaded file holds the
client_emailandprivate_key. Store it securely.


Step 2: Give the service account domain-wide access
A Google Workspace super administrator opens the Admin console → Security → Access and data control → API controls.
Click Manage Domain Wide Delegation → Add new.
Enter the service account's client ID, add the scope
https://www.googleapis.com/auth/cloud-platform, and click Authorize. See Control API access with domain-wide delegation for details.
Note: the connection signs in as the user you enter in User email, so that user must belong to the Workspace domain where domain-wide delegation was granted. Google says changes can take up to 24 hours to apply.
Step 3: Create the connection in UnifyApps
Open Connections → New Connection → Google AI and enter a Connection name.
Enter the GCP project service account email (the
client_emailfrom the JSON key file).Paste the Private key (the
private_keyfrom the JSON key file).Enter the User email of the Workspace user the service account acts as.
Click Test Connection to validate the credentials, then click Create.
Actions
Every action uses the cloud-platform scope that the connection requests. The API listed for each action must be enabled in the Google Cloud project.
Actions | Description | API to enable |
|---|---|---|
| Detects text in an image using Google AI. | Cloud Vision API |
| Converts speech to text using Google AI. | Cloud Speech-to-Text API |
| Converts text to speech using Google AI. | Cloud Text-to-Speech API |