Links diretos

O Google Home app (GHA) é a principal maneira de os usuários conectarem dispositivos inteligentes ao Google Assistant e atribuí-los a estruturas e cômodos no Google Home Graph. Para fazer a configuração, os usuários normalmente clicam em várias telas para encontrar sua Cloud-to-cloud integração em uma lista de opções disponíveis. Ao facilitar o processo de configuração para os usuários, você pode ajudar a integrá-los mais rapidamente e reduzir a frustração deles.

O link direto permite incorporar um link direto no site do app ou do produto para que os usuários possam conectar facilmente o dispositivo smart home ao Assistant. Ao clicar no link, os usuários são solicitados a fazer o download do GHA (se ainda não estiver instalado) e o fluxo de configuração de vinculação de contas e atribuição de cômodos é iniciado.

Link direto para o Google Home

Os links diretos permitem que você leve os usuários diretamente a um destino específico em GHA pelo Android ou app iOS, simplificando o processo de configuração do dispositivo.

Para iniciar a vinculação de contas diretamente no GHA, use o seguinte link universal:

https://home.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id

Em que agent-id é o ID do projeto da sua integração de nuvem para nuvem, que pode ser encontrado no Google Home Developer Console nas configurações do projeto.

Para aplicativos para dispositivos móveis que são iniciados usando um esquema personalizado (Android e iOS), você também pode usar:

googlehome://setup/ha_linking?agent_id=agent-id

Quando os usuários clicam no link universal, a plataforma móvel verifica a presença do GHA e abre o fluxo de vinculação de contas. Se o GHA não estiver instalado no dispositivo do usuário, forneça tratamento de fallback para direcionar o usuário a instalar ou atualizar o app no Google Play ou na App Store da Apple.

Intent explícita do Android

Para acionar o fluxo de vinculação de contas diretamente do app Android usando uma intent explícita:

val intent = Intent(Intent.ACTION_VIEW).apply {
    val agentId = "YOUR_AGENT_ID"
    data = Uri.parse("googlehome://setup/ha_linking?agent_id=$agentId")
    setPackage("com.google.android.apps.chromecast.app")
}
try {
    startActivity(intent)
} catch (e: ActivityNotFoundException) {
    // Fallback: open Google Play app, with web browser safety
    try {
        val playStoreIntent = Intent(Intent.ACTION_VIEW,
            Uri.parse("market://details?id=com.google.android.apps.chromecast.app"))
        startActivity(playStoreIntent)
    } catch (e: ActivityNotFoundException) {
        val playStoreUrl =
            "https://play.google.com/store/apps/details?id=com.google.android.apps.chromecast.app"
        val webIntent = Intent(Intent.ACTION_VIEW, Uri.parse(playStoreUrl))
        startActivity(webIntent)
    }
}

Os URLs de links diretos legados formatados com madeby.google.com ou assistant.google.com foram descontinuados:

https://madeby.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id

Atualize todos os botões no app e sites de produtos para usar o link universal ou o esquema personalizado googlehome://setup/ha_linking.

Para mais detalhes sobre como acionar links diretos no app, consulte a documentação relevante do Android e a documentação do iOS.