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

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 – идентификатор проекта интеграции типа "облако – облако", который можно найти в 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.