Google Assistant

4 min čtení

Díky propojení s Google Assistantem můžete ovládat svoje chytrá zařízení připojená k Home Assistantu hlasem přes telefon, tablet nebo chytrý reproduktor Google Home. Tento návod vás krok za krokem provede nastavením – ať už využíváte náš Richpear Cloud (doporučeno) nebo zvolíte plně manuální konfiguraci.

1  Přehled

Integrace Google Assistant zpřístupní vaše entity
Pokud potřebujete posílat příkazy opačným směrem – tedy z Home Assistantu do ekosystému Google Assistant (např. „Broadcast“ zprávy), podívejte se na samostatnou integraci Google Assistant SDK.

2  Rychlé připojení přes Richpear Cloud

Nejjednodušší cesta vede přes náš Richpear Cloud (technicky využívá Home Assistant Cloud). Stačí několik kliknutí:

V rozhraní Home Assistantu otevřete Nastavení ▸ Richpear Cloud a přihlaste se (30 denní zkušební období je zdarma).
V kartě Integrace zvolte Google Assistant ▸ Přidat.
Přihlaste se svým Google účtem a potvrďte propojení.
Hotovo – zařízení se objeví v aplikaci Google Home a můžete je přiřadit do místností nebo jim dát vlastní název.

Výhody Richpear Cloudu
• Žádné starosti s DDNS, SSL certifikáty ani port‑forwardingem.
• Okamžitá, šifrovaná komunikace.
• Možnost zrušit kdykoli – integrace v Home Assistantu zůstane funkční offline.

3  Manuální nastavení (bez Richpear Cloud)

Pokud chcete mít vše pod vlastní správou, postupujte podle kapitoly 3.

3.1 Předpoklady

Home Assistant musí být dostupný z internetu pod veřejným hostname (např. ha.domena.cz) a s platným SSL certifikátem.
DNS záznamy mohou trvat až 48 h, než se rozšíří – před pokračováním ověřte, že se na URL připojíte z mobilních dat.

3.2 Konfigurace Google Cloud Platform

Na console.cloud.google.com založte nový projekt.
V průvodci Smart Home > Cloud‑to‑Cloud klepněte na Next: Develop → Next: Setup.
Zvolte všechny typy zařízení, nahrajte ikonu 144 × 144 px a vyplňte Account Linking:
- OAuth Client ID: https://oauth-redirect.googleusercontent.com/r/PROJECT_ID
- Authorization URL: https://vaše‑domena.cz/auth/authorize
- Token URL: https://vaše‑domena.cz/auth/token
- Cloud fulfillment URL: https://vaše‑domena.cz/api/google_assistant
Uložte a v levém menu otevřete IAM & Admin ▸ Service Accounts. Vytvořte Service Account a přiřaďte roli Service Account Token Creator.
Na kartě Keys vytvořte nový soukromý klíč (JSON) – stáhne se soubor, který přejmenujte na SERVICE_ACCOUNT.json.

3.3 Příprava Home Assistantu

Nahrajte SERVICE_ACCOUNT.json do adresáře s konfigurací (config/).
Do configuration.yaml přidejte:

# Google Assistant
google_assistant:
  project_id: PROJECT_ID
  service_account: !include SERVICE_ACCOUNT.json
  report_state: true          # (volitelné) rychlejší odezvy
  exposed_domains:            # publikované domény
    - switch
    - light

Uložte a restartujte Home Assistant.

3.4 Spárování v aplikaci Google Home

Otevřete aplikaci Google Home ➜ Zařízení ➜ tlačítko + ➜ Works with Google.
V seznamu najděte položku [test] Název vaší aplikace.
Přihlaste se do Home Assistantu, potvrďte oprávnění a přiřaďte zařízení do místností.

Tip: Pokud máte Home Assistant připnutý na domovské obrazovce telefonu jako PWA, přejeďte ikonu pryč – jinak se místo prohlížeče otevře web‑aplikace a přesměrování selže.

3.5 Sdílení s dalšími členy domácnosti

V Google Cloud Console v projektu otevřete IAM ▸ Grant Access.
Zadejte Gmail uživatele a roli Project > Viewer.
Odkaz https://console.home.google.com/projects/PROJECT_ID přepošlete uživateli – po jeho otevření a potvrzení TOS lze integraci přidat v Google Home stejným způsobem jako v bodu 3.4.

3.6 Lokální plnění (Local Fulfillment) – volitelné

Zrychluje reakce tím, že příkazy běží přímo v lokální síti (mDNS _home‑assistant._tcp.local).
V sekci Cloud‑to‑Cloud ▸ Develop zatrhněte Enable Local Fulfillment, nahrajte skript app.js (Node + Chrome) a přidejte scan konfiguraci viz originální dokumentace.
HTTP integrace nesmí mít vlastní SSL certifikát – pro bezpečný vzdálený přístup použijte reverzní proxy (např. NGINX SSL Add‑on).

4  Podporované domény a zabezpečení

Google Assistant aktuálně umí desítky domén; nejpoužívanější:

Doména	Akce
`light`, `switch`, `scene`	zap./vyp., jas, barva
`climate`	režimy (heat/cool/auto), teplota
`cover` (door, garage)	otevřít/zavřít, pozice
`lock`, `alarm_control_panel`	vyžadují PIN pro odemknutí

Bezpečná zařízení (zámky, alarmy, garážová vrata) lze otevírat jen po zadání PINu: v configuration.yaml přidejte secure_devices_pin: 1234.

5  Nejčastější potíže a jejich řešení

Příznak	Rychlá oprava
„Unable to sync Home Assistant“ po „Ok Google, sync my devices“	V Actions on Google > Test > Simulator klikněte Start Testing a zkuste znovu.
Chyba 404 nebo 403 při `google_assistant.request_sync`	Ověřte, že HomeGraph API je povoleno a `project_id` sedí.
Hlásí Could not update the setting při párování	Zkontrolujte `Fulfillment URL` a SSL certifikát; případně dočasně expose‑ujte jen jedno jednoduché zařízení.
Lokální plnění nereaguje	Restartujte všechny Google Home zařízení, počkejte 30 minut, ověřte mDNS `_home-assistant._tcp.local`.

Další zdroje

Podrobný návod k Local Fulfillment: https://developers.google.com/assistant/smarthome/concepts/local
Fórum podpory Richpear: forum.richpear.cz

Napsat komentář 0

1 Přehled

2 Rychlé připojení přes Richpear Cloud

3 Manuální nastavení (bez Richpear Cloud)