Links diretos

O Google Home app (GHA) é a principal maneira de os usuários conectarem dispositivos inteligentes ao Google Assistant e os atribuírem a estruturas e ambientes no Google Home Graph. Para realizar a configuração, os usuários geralmente clicam em várias telas para encontrar sua integração do Cloud-to-cloud em uma lista de opções disponíveis. Ao facilitar o início do processo de configuração, você ajuda os usuários a concluir a integração mais rapidamente e reduz a frustração deles.

Com os links diretos, é possível incorporar um link direto no seu app ou site de produtos para que os usuários conectem 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 ambientes é iniciado.

Link direto para o Google Home

Com os links diretos, você pode levar os usuários diretamente a um destino específico no GHA do seu app iOS ou Android, 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 integração de nuvem para nuvem, que pode ser encontrado no Google Home Developer Console em "Configurações do projeto".

Para aplicativos para dispositivos móveis que usam 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 para dispositivos móveis 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 um tratamento de substituição para direcionar o usuário para 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 seu 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 link direto 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 do 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 seu app, consulte a documentação do Android e a documentação do iOS.