Глубокие ссылки

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

Функция Deep Linking позволяет встраивать прямые ссылки в ваше приложение или веб-сайт продукта, чтобы пользователи могли легко подключить свои устройства 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 .