계정 연결
개요
작업이 다양한 플랫폼(예: 웹 또는 Android)의 기존 앱과 호환되는 경우 계정 연결을 사용하여 사용자의 환경설정을 모든 플랫폼에 안전하게 제공할 수 있으므로 일관적인 크로스 플랫폼 환경이 보장됩니다.
Actions on Google용 계정 연결에는 Google의 안전한 인증 시스템인 Google 로그인과 필요에 따라 인증을 위한 업계 표준 프로토콜인 OAuth 2.0이 사용됩니다.
자세한 내용은 개발자 사이트를 참조하세요.
![](https://developers.google.cn/static/assistant/conversation-design/images/account-linking-hero.png?authuser=19&hl=ko)
연결 흐름
- 인증 시스템에서 계정과 일치하는 항목을 찾습니다 (사용자가 이미 다른 플랫폼에서 내 작업 또는 앱 중 하나를 사용한 경우).
- 인증 시스템에서 새 사용자를 위한 새 계정 만들기
3가지 연결 방법
계정 연결 방법에는 3가지가 있습니다.
Google 로그인
어시스턴트용 Google 로그인을 사용하면 대화 중에 대화 중에 사용자의 Google 프로필에 대한 액세스를 요청할 수 있습니다 (사용자의 이름, 이메일 주소, 프로필 사진 포함). 사용자는 음성을 통해 전체 흐름을 완료할 수 있어 원활한 로그인 환경을 제공합니다.
다음의 경우 Google 로그인을 사용합니다.
- 내 작업이 어시스턴트만 타겟팅합니다.
- 기존 인증 시스템이 없습니다.
- 기존 인증 시스템이 있지만 @gmail.com 주소를 사용하여 기존 앱에 가입한 사용자만 연결하려고 합니다.
![](https://developers.google.cn/static/assistant/conversation-design/images/gsi-only-hero.png?authuser=19&hl=ko)
OAuth 및 Google 로그인
OAuth 및 Google 로그인 연결 유형은 OAuth 기반 계정 연결 위에 Google 로그인을 추가합니다. 이를 통해 Google 사용자에게 원활한 음성 기반 연결을 제공하는 동시에 Google 이외의 ID로 서비스에 등록한 사용자의 계정 연결을 사용 설정할 수 있습니다.
이 흐름을 사용하려면 지원되는 OAuth 2 표준 흐름 중 하나를 확장하여 프로토콜의 Google 독점 확장 프로그램에 대한 지원을 추가해야 합니다.
다음과 같은 경우 OAuth 및 Google 로그인을 사용하세요.
- 멀티 플랫폼 액션이 있음
- 기존 인증 시스템이 있고 사용자가 @gmail.com 외의 주소에 연결하도록 허용하려는 경우
- Google 프로필 정보를 사용하여 계정을 연결하려는 경우
- Google 프로필 정보를 사용하여 새 계정을 만들어야 함 (선택사항)
![](https://developers.google.cn/static/assistant/conversation-design/images/gsi-oauth-hero.png?authuser=19&hl=ko)
OAuth
OAuth 계정 연결 유형은 다음과 같은 두 가지 업계 표준 OAuth 2.0 흐름을 지원합니다.
- 암시적 코드 흐름
- 승인 코드 흐름
이 흐름은 사용자 상호작용을 음성에서 화면으로 전송해야 하므로 권장하지 않습니다.
다음과 같은 경우 OAuth 사용을 고려하세요.
- OAuth 2 서버가 이미 구현되어 있으며, 토큰 교환 엔드포인트를 확장하여 ID 토큰에서 자동 연결 및 계정 생성에 대한 Google 프로토콜 지원을 추가할 수 없습니다.
자세한 내용은 OAuth 개발자 가이드를 참고하세요.