Skip to content

App Settings

Arie J. Godschalk edited this page Nov 15, 2026 · 1 revision

Home

App settings

Open Apps → Google Services → Settings in Homey. These fields are app-wide, not individual device settings. Enter the values for the services you use and select Save.

Google Cloud Service Account JSON

Paste the entire JSON key file for your own service account, not its filename or project ID. It is used by cloud speech and translation. Keep it secret; never put it in a Flow, screenshot, issue or Wiki. An empty field removes cloud credentials. Follow Getting started to create it.

Google Cloud Default Voice

After saving valid JSON, wait for the voice list to load, choose a voice and save again. The list is obtained from Google and cached for up to ten minutes. Searchable voice arguments on some cards can override this default. The current settings code saves a voice only when its list position is greater than the first; if selecting the first entry does not stick, select another and save. If the list is empty, check credentials, enabled API, billing and Homey notifications.

Google Cloud Project (for Translate)

Enter the exact, case-sensitive project ID, not a display name or project number. Example placeholder: YOUR_PROJECT_ID. Translation sends requests to that project.

Google API Key (for YouTube)

Enter your own API key for a project with YouTube Data API v3 enabled. This is separate from the service-account JSON. Keep it private.

Google API Key (for Maps)

The settings screen also displays this field. It is not needed by the supported speech, translation or YouTube devices. Leave it empty unless you independently need it.

Save and check

The screen reports “Saved” and refreshes the voice list shortly afterwards. Verify the actual result by reopening settings and running a small example; a saved message alone does not prove a Google request will work. When rotating credentials, update the field and verify each service again. See Troubleshooting.

Clone this wiki locally