Обнаружение приложений и глубокие ссылки

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

Чтобы упростить подключение пользователей к устройствам smart home , платформа smart home Google предлагает несколько удобных функций, которые упрощают пользователям быстрый вход в процесс настройки и начало использования своего устройства smart home . Эти функции можно легко интегрировать в вашу Cloud-to-cloud интеграцию практически без усилий по написанию кода.

В следующем списке перечислены функции платформы, которые вы можете реализовать, чтобы уменьшить неудобства для пользователей при настройке ваших интеллектуальных устройств для Assistant :

  • App Discovery : эта функция позволяет пользователям видеть чипы предложений для связи с вашей Cloud-to-cloud интеграцией в GHA ; Нажав на чип, они смогут подключить свои устройства smart home к Assistant используя учетные записи стороннего поставщика.
  • Глубокая ссылка : эта функция позволяет встроить глубокую ссылку в ваше приложение или веб-сайт продукта, чтобы пользователи могли легко подключить свое smart home устройство к Assistant . Нажатие на ссылку предлагает пользователям загрузить GHA (если он еще не установлен) и запускает процесс привязки учетной записи и настройки назначения комнаты.

Внедрить обнаружение приложений

Вы можете включить функцию App Discovery из Google Home Developer Console после завершения процесса проверки бренда . Никаких изменений кода не требуется, однако ваша интеграция Cloud-to-cloud уже должна быть проверена и запущена в производство.

Войдите в Developer Console :

Зайдите в консоль разработчика

  1. Откройте проект интеграции Cloud-to-cloud .

  2. Нажмите Профиль компании .

  3. Следуйте инструкциям в разделе «Создание профиля компании» , чтобы подключить веб-сайт вашей компании к вашему проекту интеграции.

Глубокая ссылка на Google Home

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

Синтаксис глубоких ссылок GHA следующий:

https://home.google.com/home-app/?deeplink=destination

Ваше приложение Android или iOS в настоящее время может ссылаться на следующие направления в GHA :

Место назначения Описание
setup/ha_linking?agent_id= agent-id Инициируйте процесс связывания учетной записи OAuth для данного agent-id интеграции Cloud-to-cloud .

Путь назначения должен быть правильно закодирован в URL-адресе , прежде чем применять его к глубокой ссылке. Например:

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

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