Ссылки на контент

Google Home app (GHA) – это основной способ, с помощью которого пользователи подключают умные устройства к Google Assistant и назначают их домам и комнатам в Google Home Graph. Чтобы выполнить настройку, пользователям обычно приходится просматривать несколько экранов, чтобы найти вашу интеграцию в списке доступных вариантов.Cloud-to-cloud Если вы упростите начало настройки, пользователи смогут быстрее начать работу с устройством и будут меньше раздражаться.

Вы можете встроить ссылку на контент в свое приложение или на сайт, чтобы пользователи могли легко подключить устройство smart home к Assistant. Нажав на ссылку, пользователь сможет скачать приложение GHA (если оно ещё не установлено) и запустить процесс связывания аккаунтов и назначения комнат.

Ссылка на контент в Google Home

Ссылки на контент позволяют направлять пользователей напрямую в определенный раздел GHA из вашего приложения для Android или приложения iOS, упрощая процесс настройки устройства.

Чтобы инициировать связывание аккаунтов непосредственно в GHA, используйте следующую универсальную ссылку:

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

где agent-id – идентификатор проекта интеграции Cloud-to-Cloud, который можно найти в Google Home Developer Console в настройках проекта.

Для мобильных приложений, запускаемых с помощью специальной схемы (Android и iOS), также можно использовать:

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

Когда пользователь нажимает на универсальную ссылку, мобильная платформа проверяет наличие GHA и запускает процесс связывания аккаунтов. Если на устройстве пользователя не установлено приложение GHA, обеспечьте резервную обработку, чтобы перенаправить пользователя в Google Play или Apple App Store для установки или обновления приложения.

Явный интент Android

Чтобы запустить процесс связывания аккаунтов непосредственно из приложения для Android с помощью явного намерения, выполните следующие действия:

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)
    }
}

Устаревшие URL ссылок на контент в формате madeby.google.com или assistant.google.com больше не поддерживаются.

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

Обновите все кнопки приложения и на сайтах продуктов, чтобы использовать универсальную ссылку или специальную схему googlehome://setup/ha_linking.

Подробную информацию о том, как активировать ссылки на контент в приложении, можно найти в документации для Android и iOS.