Добро пожаловать в Центр разработчиков Google Home, новое место, где можно научиться разрабатывать действия для умного дома. Примечание. Вы продолжите создавать действия в консоли действий.

Связывание аккаунта

Каждое действие smart home должно включать механизм аутентификации пользователей.

Аутентификация позволяет связать учетные записи Google ваших пользователей с учетными записями пользователей в вашей системе аутентификации. Это позволяет вам идентифицировать ваших пользователей, когда ваше выполнение получает намерение умного дома. Умный дом Google поддерживает только OAuth с потоком кода авторизации.

Если у вас есть реализация OAuth 2.0, вы можете дополнительно настроить App Flip на основе OAuth , что позволит вашим пользователям быстрее связать свои учетные записи в вашей системе аутентификации со своими учетными записями Google.

OAuth

Для smart home необходимо использовать OAuth с потоком кода авторизации, что требует наличия двух конечных точек: конечных точек авторизации и обмена токенами .

Когда вы аутентифицируете пользователя, сторонний токен доступа OAuth 2.0 пользователя отправляется в заголовке авторизации, когда намерения smart home отправляются на ваше выполнение. Все пользователи должны выполнить привязку учетной записи, поскольку информация об устройстве отправляется в Google Assistant с намерением action.devices.SYNC , которое требует привязки учетной записи.

Ожидается, что действие вашего smart home будет поддерживать несколько пользователей Google, подключающихся к одной и той же учетной записи пользователя (например, когда пользователи предоставляют доступ другим пользователям в своей семье). Если ваша служба не может поддерживать несколько пользовательских подключений, она должна выдавать ошибки во время связывания учетной записи.

Инструкции по настройке сервера OAuth 2.0 для действия см. в разделе Реализация сервера OAuth 2.0 .

Переворот приложений на основе OAuth

Связывание App Flip Linking (App Flip) на основе OAuth позволяет вашим пользователям легко и быстро связать свои учетные записи в вашей системе аутентификации со своими учетными записями Google. Если ваше приложение установлено на телефоне вашего пользователя, когда он инициирует процесс привязки учетной записи, он легко переключается на ваше приложение для получения авторизации пользователя.

Этот подход обеспечивает более быстрый и простой процесс связывания, поскольку пользователю не нужно повторно вводить свое имя пользователя и пароль для аутентификации; вместо этого App Flip использует учетные данные из учетной записи пользователя в вашем приложении. Как только пользователь свяжет свою учетную запись Google с вашим приложением, он сможет воспользоваться преимуществами любых разработанных вами интеграций.

Вы можете настроить App Flip для приложений iOS и Android.

На этом рисунке показаны шаги, необходимые пользователю для привязки своей учетной записи Google к вашей системе аутентификации. На первом снимке экрана показано, как пользователь может выбрать ваше приложение, если его учетная запись Google связана с вашим приложением. На втором снимке экрана показано подтверждение привязки их учетной записи Google к вашему приложению. На третьем снимке экрана показана успешно связанная учетная запись пользователя в приложении Google.
Рис. 1. Связывание учетной записи на телефоне пользователя с App Flip.

Требования

Для реализации App Flip необходимо выполнить следующие требования:

  • У вас должно быть приложение для Android или iOS.
  • Вы должны владеть, управлять и поддерживать сервер OAuth 2.0, который поддерживает поток кода авторизации OAuth 2.0.

Дополнительные сведения о потоке кода авторизации связывания OAuth см. в разделе Внедрение сервера OAuth 2.0 .

Инструкции по настройке App Flip для вашего действия см. в разделе App Flip на основе OAuth .