스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.

계정 연결

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

모든 smart home 작업에는 사용자를 인증하기 위한 메커니즘이 포함되어야 합니다.

인증을 통해 사용자의 Google 계정을 인증 시스템의 사용자 계정과 연결할 수 있습니다. 이렇게 하면 처리에서 스마트 홈 인텐트를 수신할 때 사용자를 식별할 수 있습니다. Google 스마트 홈은 승인 코드 흐름이 있는 OAuth만 지원합니다.

OAuth 2.0을 구현하면 OAuth 기반 App Flip를 선택적으로 구성할 수 있습니다. 이를 통해 사용자는 인증 시스템의 계정을 Google 계정에 더 빠르게 연결할 수 있습니다.

OAuth

smart home의 경우 승인 코드 흐름에 OAuth를 사용해야 하며, 이때 두 가지 엔드포인트, 즉 승인토큰 교환 엔드포인트가 있어야 합니다.

사용자를 인증한 후 smart home 인텐트가 처리에 전송되면 사용자의 서드 파티 OAuth 2.0 액세스 토큰이 승인 헤더로 전송됩니다. 모든 사용자가 계정 연결을 실행해야 합니다. 기기 정보가 계정 연결이 필요한 action.devices.SYNC 인텐트로 Google Assistant에 전송되기 때문입니다.

smart home 작업은 동일한 사용자 계정에 연결하는 여러 Google 사용자를 지원해야 합니다 (예: 사용자가 가족의 다른 사용자에게 액세스 권한을 부여하는 경우). 서비스에서 여러 사용자 연결을 지원할 수 없는 경우 계정 연결 시 오류를 제공해야 합니다.

작업에 OAuth 2.0 서버를 설정하는 방법은 OAuth 2.0 서버 구현을 참고하세요.

OAuth 기반 앱 플립

OAuth 기반 앱 플립 연결 (App Flip)을 사용하면 사용자가 인증 시스템의 계정을 Google 계정에 쉽고 빠르게 연결할 수 있습니다. 계정 연결 절차를 시작할 때 앱이 사용자 휴대전화에 설치되면 앱으로 원활하게 전환하여 사용자 승인을 받을 수 있습니다.

이 접근 방식은 사용자가 사용자 이름과 비밀번호를 다시 입력하지 않아도 되므로 더 빠르고 쉬운 연결 프로세스를 제공합니다. 대신 앱 플립이 앱에서 사용자 계정의 사용자 인증 정보를 활용합니다. 사용자는 Google 계정을 앱에 연결하면 개발한 통합 기능을 활용할 수 있습니다.

앱 플립은 iOS 앱과 Android 앱 모두에 설정할 수 있습니다.

이 그림은 사용자가 Google 계정을 인증 시스템에 연결하는 단계를 보여줍니다. 첫 번째 스크린샷은 Google 계정이 앱에 연결된 경우 사용자가 앱을 선택하는 방법을 보여줍니다. 두 번째 스크린샷은 Google 계정을 앱과 연결하기 위한 확인을 보여줍니다. 세 번째 스크린샷은 Google 앱에서 성공적으로 연결된 사용자 계정을 보여줍니다.
그림 1. 앱 플립이 있는 사용자 휴대전화에 연결된 계정

요구사항

앱 플립을 구현하려면 다음 요구사항을 충족해야 합니다.

  • Android 또는 iOS 앱이 있어야 합니다.
  • OAuth 2.0 승인 코드 흐름을 지원하는 OAuth 2.0 서버를 소유, 관리, 유지해야 합니다.

OAuth 연결 승인 코드 흐름에 관한 자세한 내용은 OAuth 2.0 서버 구현을 참고하세요.

작업에 App Flip를 구성하는 방법은 OAuth 기반 App Flip를 참고하세요.