Google Cloud

The Google Cloud integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to use Google Cloud Platform APIs and integrate them into Home Assistant.

Configuration

To add the Google Cloud service to your Home Assistant instance, use this My button:

Obtaining service account file

1. Visit Cloud Resource Manager.

2. Click CREATE PROJECT button at the top.

3. Specify convenient Project name and click CREATE button.

4. Make sure that billing is enabled for your Google Cloud Platform project.

5. Enable needed Cloud API visiting one of the links below or APIs library, selecting your Project from the dropdown list and clicking the Continue button:

   • Text-to-speech
   • Speech-to-text

6. Set up authentication:

   1. Visit this link

   2. From the toolbar above the Service account list, select Create service account.

   3. In the Service account name field, enter any name.

      If you are setting up text-to-speech:

      1. Don’t select a value from the Role list. No role is required to access this service.
      2. Click Create. If a note appears, warning that this service account has no role, you may ignore that.
      3. Return to the Service account list page and click on the service account you created to see the details for this service account.
      4. Choose the Keys tab within the details view for this service account.
      5. In the Add Key dropdown, select Create New Key.
      6. Specify a JSON key type and click Create.
      7. A [serviceaccountname].json file will download to your browser.
      8. Upload this file when asked in the integration setup.

Google Cloud text-to-speech

Google Cloud text-to-speech converts text into human-like speech in 380+ voices across 50+ languages and variants. It applies groundbreaking research in speech synthesis and Google’s powerful neural networks to deliver high-fidelity audio. With this easy-to-use API, you can create lifelike interactions with your users that transform customer service, device interaction, and other applications.

Pricing

The Cloud text-to-speech API is priced monthly based on the number of characters to synthesize into audio sent to the service. For up-to-date pricing, see here.

Text-to-speech configuration

The following settings can be configured in the integration options and in the Options field of the Speak action.

Using Google Cloud text-to-speech in automations

To play a message from an automation or script, use the Speak action and select your Google Cloud text-to-speech entity as the target.

To speak a message from an automation or a script:

1. Go to Settings > Automations & scenes.
2. Open an existing automation or script, or select Create automation > Create new automation.
3. If you are setting up a new automation, add a trigger in the When section. Scripts do not need a trigger. They run when something else calls them.
4. In the Then do section, select Add action.
5. Select what you want to control. Under By target, select your Google Cloud text-to-speech entity.
6. From the actions shown for that target, select Speak. To use Google Cloud-specific settings, set them in Options. For supported options, see Text-to-speech configuration.
7. Select the Media player entity to play the message on, set the Message, and set any other options you want to use.
8. Select Save.

If you still use the legacy Google Cloud text-to-speech platform in configuration.yaml, use the Say a TTS message action. In YAML, the legacy Google Cloud action is tts.google_cloud_say.

Google Cloud speech-to-text

Google Cloud speech-to-text converts audio into text transcriptions for 125 languages and variants.

Pricing

Speech-to-text is priced based on the amount of audio successfully processed by the service each month, measured in increments of one second. For up-to-date pricing, see here under the Speech-to-text v1 API.

Speech-to-text configuration